MD语法入门

md即markdown文件的基本常用编写语法,是一种快速标记、快速排版语言,现在很多前段项目中的说明文件readme等都是用.md文件编写的,而且很多企业也在在鼓励使用这种编辑方式,特别作为一个前端从业者更要学会使用这种语言。下面就简单和大家分享一些.md基本语法

一、基本符号:* – +. >

基本上所有的markdown标记都是基于这四个符号或组合,需要注意的是,如果以基本符号开头的标记,注意基本符号后有一个用于分割标记符和内容的空格。

二、标题

1.前面带#号,后面带文字,分别表示h2-h6,只到h6,而且h2下面会有一条横线

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

2.相当于标签闭合

# 一级标题 #
## 二级标题 ##
### 三级标题 ###
#### 四级标题 ####
##### 五级标题 #####
###### 六级标题 #####

三、列表

无序列表

//形式一
+ a
+ b
+ c
//形式二
- d
- e
- f
//形式三
* g
* h
* i

以上三种形式,效果其实都是一样的。

有序列表

//正常形式
1. abc
2. bcd
3. cde
//错序效果
2. fgh
3. ghi
5. hij

如图,注意,数字后面的点只能是英文的点,有序列表的序号是根据第一行列表的数字顺序来的,
错序列表的序号本来是序号是乱的, 但是还是显示 2 3 5

嵌套列表

//无序列表嵌套
+ 123
    + abc
    + bcd
    + cde
+ 465
+ 789
//有序列表嵌套
1. abcd
    1. abcde
    2. abcde
    3. abcde
2. bcde
3. cdef

列表可以嵌套,使用时在嵌套列表前按 tab 或 空格 来缩进,去控制列表的层数

四、引用说明区块

对某个部分做的内容做一些说明或者引用某某的话等,可以用这个语法。

  1. 正常形式
    > 引用内容、说明内容。在语句前面加一个 > ,注意是英文的那个右尖括号,注意空格,引用因为是一个区块,理论上是应该什么内容都可以放,比如说:标题,列表,引用等等。
  2. 嵌套区块
    这里我只介绍一下我常用的方法,也是个人认为比较规范的一种方法,就是给区块的下一级区块多加一个右尖括号

    > 一级引用
    >> 二级引用
    >>> 三级引用
    >>>> 四级引用
    >>>>> 五级引用
    >>>>>> 六级引用
    

五、代码块

在发布一些技术文章会涉及展示代码的问题,这时候代码块就显得尤为重要。

  1. 少量代码,单行使用,直接用`包裹起来就行了
    ` shaoliangdaima,danhangshiyong `
  2. 大量代码,需要多行使用,用“`包裹起来
        ```
            daliangdaima,xuyaoduohangshiyong
            daliangdaima,xuyaoduohangshiyong
            daliangdaima,xuyaoduohangshiyong
            daliangdaima,xuyaoduohangshiyong
            daliangdaima,xuyaoduohangshiyong
        ```
    

六、链接

  1. 行内式
    链接的文字放在[]中,链接地址放在随后的()中,链接也可以带title属性,链接地址后面空一格,然后用引号引起来

    [霜天博客](https://www.i5seo.com"方便的创作自己的作品,互相交流。 ") 
  2. 参数式
    链接的文字

    [霜天博客]: https://www.i5seo.com "方便的创作自己的作品,互相交流。"
    [霜天博客]方便的创作自己的作品,互相交流。
    //参数定义的其他写法
    [霜天博客]: https://www.i5seo.com '方便的创作自己的作品,互相交流。'
    [霜天博客]: https://www.i5seo.com (方便的创作自己的作品,互相交流。)
    [霜天博客]: <https://www.i5seo.com> "方便的创作自己的作品,互相交流。"
    

    放在[]中,链接地址放在随后的:后,链接地址后面空一格,然后用引号引起来

@[toc](目录)
Markdown 语法简介
=============
> [语法详解](http://commonmark.org/help/)
## **粗体**
“`
**粗体**
__粗体__
“`
## *斜体*
“`
*斜体*
_斜体_
“`
## 标题
“`
# 一级标题 #
一级标题
====
## 二级标题 ##
二级标题
—-
### 三级标题 ###
#### 四级标题 ####
##### 五级标题 #####
###### 六级标题 ######
“`
## 分割线
“`
***

“`
****
## ^上^角~下~标
“`
上角标 x^2^
下角标 H~2~0
“`
## ++下划线++ ~~中划线~~
“`
++下划线++
~~中划线~~
“`
## ==标记==
“`
==标记==
“`
## 段落引用
“`
> 一级
>> 二级
>>> 三级

“`
## 列表
“`
有序列表
1.
2.
3.

无序列表



“`
## 任务列表
– [x] 已完成任务
– [ ] 未完成任务
“`
– [x] 已完成任务
– [ ] 未完成任务
“`
## 链接
“`
[链接](www.baidu.com)
![图片描述](http://www.image.com)
“`
## 代码段落
\“` type
代码段落
\“`
\` 代码块 \`
“`c++
int main()
{
printf(“hello world!”);
}
“`
`code`
## 表格(table)
“`
| 标题1 | 标题2 | 标题3 |
| :– | :–: | —-: |
| 左对齐 | 居中 | 右对齐 |
| ———————- | ————- | —————– |
“`
| 标题1 | 标题2 | 标题3 |
| :– | :–: | —-: |
| 左对齐 | 居中 | 右对齐 |
| ———————- | ————- | —————– |
## 脚注(footnote)
“`
hello[^hello]
“`
见底部脚注[^hello]
[^hello]: 一个注脚
## 表情(emoji)
[参考网站: https://www.webpagefx.com/tools/emoji-cheat-sheet/](https://www.webpagefx.com/tools/emoji-cheat-sheet/)
“`
:laughing:
:blush:
:smiley:
🙂

“`
:laughing::blush::smiley::)
## $\KaTeX$公式
我们可以渲染公式例如:$x_i + y_i = z_i$和$\sum_{i=1}^n a_i=0$
我们也可以单行渲染
$$\sum_{i=1}^n a_i=0$$
具体可参照[katex文档](http://www.intmath.com/cg5/katex-mathjax-comparison.php)和[katex支持的函数](https://github.com/Khan/KaTeX/wiki/Function-Support-in-KaTeX)以及[latex文档](https://math.meta.stackexchange.com/questions/5020/mathjax-basic-tutorial-and-quick-reference)
## 布局
::: hljs-left
`::: hljs-left`
`居左`
`:::`
:::
::: hljs-center
`::: hljs-center`
`居中`
`:::`
:::
::: hljs-right
`::: hljs-right`
`居右`
`:::`
:::
## 定义
术语一
: 定义一
包含有*行内标记*的术语二
: 定义二
{一些定义二的文字或代码}
定义二的第三段
“`
术语一
: 定义一
包含有*行内标记*的术语二
: 定义二
{一些定义二的文字或代码}
定义二的第三段
“`
## abbr
*[HTML]: Hyper Text Markup Language
*[W3C]: World Wide Web Consortium
HTML 规范由 W3C 维护
“`
*[HTML]: Hyper Text Markup Language
*[W3C]: World Wide Web Consortium
HTML 规范由 W3C 维护
“`

发表评论