Markdown语法

Markdown语法

工具

Typora 或者 马克飞象

语法

一.Markdown标题

1.使用 = 和 - 标记一级二级标题

= 和 -标记语法格式如下

我展示的是一级标题

我展示的是二级标题

2.使用 # 标记标题

使用 # 可表示1-6级标题

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

####### 七级标题（最多只有六级标题）

二.Markdown段落格式

1.段落

Markdown段落没有特殊格式，直接编写文字就好，段落的换行是使用两个以上的空格+回车。

末尾添加两个空格来换行
1 Markdown
2 Markdown
也可以在段落后面使用一个空行来表示重新开始一个段落
1 Markdown
2
3 Markdown

2.字体

Markdown 可以使用一下字体

斜体文字
斜体文字 (用于英语)
粗体文字
粗体文字(用于英语)
粗斜体文字
粗斜体文字(用于英语)

3.分割线

可以在一行中使用三个以上的*(星号) -(减号) _(底线)来建立一个分割线，行内不能有其他东西。但是可以插入空格。
下面没种写法都可以建立分割线：

---

---

---

---

4.删除线

如果段落文字想要添加删除线，只需要在文字的两端加上两个~~(波浪线)即可，示例如下：

Markdown
Markdown
Markdown

5.下划线

下划线可以通过HTML的<\u>标签来实现：

带下划线文本

6.脚注

脚注是对文本的补充说明。（脚注在页面底部）
Markdown的脚本的格式如下：

[^要注明的文本]

实例演示的脚注如下：
创建脚注要类似这样 ¹。

三.Markdown列表

1.Markdown支持有序列表和无序列表。

无序列表

使用 *(星号) +(加号) -(减号)作为列表标记：

• 第一项
• 第二项
• 第三项

---

• 第一项
• 第二项
• 第三项

---

• 第一项
• 第二项
• 第三项

有序列表

使用数字并加上 . (点)来表示：

1. 第一项
2. 第二项
3. 第三项

2.列表嵌套

列表嵌套只需在子列表的选项添加四个空格即可：

1. 第一项：
   - 第一项嵌套的第一个元素
   - 第一项嵌套的第二个元素
2. 第二项：
   - 第二项嵌套的第一个元素
   - 第二项嵌套的第二个元素

四.Markdown区块

区块²

Markdown区块引用是在段落开头使用 > 符号，然后后面紧跟一个空格符号：

区块引用
Markdown

另外，区块是可以嵌套的，一个 > 是最外层，两个 >> 是第一层嵌套，以此类推：

最外层

第一层嵌套

第二层嵌套

区块中使用列表

（在马克飞象中）
有序 + 无序（. 后有空格在有序下 . 后无空格在无序下）

1. 第一项
2. 第二项

• 第一项
  1.第三项

1. 第三项

无序 + 有序（+后有空格在无序下 + 后无空格在有序下）

• 第一项

1. 第一项
2. 第二项
   +第二项

• 第二项

列表中使用区块

• 第一项

  Markdown

• 第二项

五.Markdown代码

如果是段落上的一个函数或片段的代码可以用 `(反引号)把它包起来：

printf（）函数

代码区块

1.使用4个空格或者一个Tab键(制表符)+回车

php
echo 'RUNOOB';

2.也可以使```(反引号)包裹一段代码，并指定一种语言（也可以不用）

echo 'RUNOOB';

六.Markdown链接

链接

使用方法如下：

[链接名称] (链接地址)
或者
<链接地址>

例如：

这是一个菜鸟教程链接
菜鸟教程：https://www.runoob.com

高级链接

我们可以通过一个变量来设置一个链接，变量赋值在文档末尾进行：

这个链接用 1 作为网址变量 [Google] 1
这个链接用 runoob 作为网址变量 Runoob
然后在文档的结尾为变量赋值（网址）

七.Markdown图片

Markdown图片语法如下”

！[alt 属性文本] (图片地址)

！[alt 属性文本] (图片地址’“可选标题”)

• 开头一个感叹号！
• 接着一个方括号，里面放上图片的替代文字
• 接着一个普通括号，里面放上图片的地址，最后还可以用引号包住并加上选择性的’title’属性文字。‘

使用实例：

！图片 图标

当然也可以使用像网址那样对图片地址使用变量：

这个链接用 1 作为网址变量 [图片 图标] 1
然后在文档的结尾为变量赋值（网址）

图片的高度与宽度

Markdown还没有办法指定图片的高度与宽度，如果你有需要的话，可以使用普通的标签。

八.Markdown表格

Markdown制作表格使用|来分隔不同的单元格，使用-来分隔表头和其他行。
语法格式如下：

表头	表头
单元格	单元格
单元格	单元格

对齐方式：

• -:设置内容和标题栏右对齐。
• :-设置内容和标题栏左对齐。
• :-：设置内容和标题栏居中对齐。

实例如下：

左对齐	右对齐	居中对齐
单元格	单元格
单元格	单元格	单元格

九. Markdown高级技巧

1.支持的 HTML 元素

不在Markdown涵盖范围内的标签，都可以直接在文档里面用HTML撰写 。
目前支持的HTML元素有：< kbd > < b > < i > < em > < sup > < sub > < br > 如：

使用 < Ctrl+Alt+Del>重启电脑

2.转义

Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用转义字符，Markdown 使用反斜杠转义特殊字符：

文本加粗
** 正常显示星号 **

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\ 反斜线
` 反引号

• 星号
  _ 下划线
  {} 花括号
  [] 方括号
  () 小括号
  # 井字号

• 加号

• 减号
  . 英文句点
  ! 感叹号

3.公式

当你需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后，问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如：

KaTeX parse error: Can't use function '$' in math mode at position 249: … \end{vmatrix} $̲{$tep1}{\style{…

4.Markdown 笔记

(typora 画流程图、时序图(顺序图)、甘特图
复制以下代码使用 typora 的源码模式粘贴到编辑器中查看效果：)
(1 2 7 不适用于马克飞象)
以下几个实例效果图如下：

1、横向流程图源码格式：

2、竖向流程图源码格式：

3、标准流程图源码格式：

4、标准流程图源码格式（横向）：

5、UML时序图源码样例：

6、UML时序图源码复杂样例：

7、UML标准时序图样例：

---

1. 一种轻量级的语言 ↩︎

2. 符号后有无空格影响排序。 ↩︎