Markdown常用语法

引言

Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。 它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

由于Markdown的轻量化、易读易写特性，并且对于图片，图表、数学式都有支持，许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。 如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等，甚至还能被使用来撰写电子书。

1.标题

<span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span> <span class="line">5</span> <span class="line">6</span> 1 2 3 4 5 6 <span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span> <span class="line">5</span> <span class="line">6</span>

<span class="line"><span class="section"># 一级标题</span></span> <span class="line"><span class="section">## 二级标题</span></span> <span class="line"><span class="section">### 三级标题</span></span> <span class="line"><span class="section">#### 四级标题</span></span> <span class="line"><span class="section">##### 五级标题</span></span> <span class="line"><span class="section">###### 六级标题</span></span> 1 2 3 4 5 6 <span class="line"><span class="section"># 一级标题</span></span> <span class="line"><span class="section">## 二级标题</span></span> <span class="line"><span class="section">### 三级标题</span></span> <span class="line"><span class="section">#### 四级标题</span></span> <span class="line"><span class="section">##### 五级标题</span></span> <span class="line"><span class="section">###### 六级标题</span></span>

2.字体

<span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span> 1 2 3 4 <span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span>

<span class="line"><span class="bullet">1.</span> <span class="emphasis">*斜体*</span></span> <span class="line"><span class="bullet">2.</span> <span class="strong">**加粗**</span></span> <span class="line"><span class="bullet">3.</span> <span class="strong">**<span class="emphasis">*加粗斜体<span class="strong">**<span class="emphasis">*</span></span></span></span></span> <span class="line"><span class="emphasis"><span class="strong"><span class="emphasis"><span class="strong">4. ~~删除线~~</span></span></span></span></span> 1 2 3 4 <span class="line"><span class="bullet">1.</span> <span class="emphasis">*斜体*</span></span> <span class="line"><span class="bullet">2.</span> <span class="strong">**加粗**</span></span> <span class="line"><span class="bullet">3.</span> <span class="strong">**<span class="emphasis">*加粗斜体<span class="strong">**<span class="emphasis">*</span></span></span></span></span> <span class="line"><span class="emphasis"><span class="strong"><span class="emphasis"><span class="strong">4. ~~删除线~~</span></span></span></span></span>

输出结果：

1. 斜体
2. 加粗
3. 加粗斜体
4. 删除线

3.列表

3.1无序列表

使用 * ，+ ， – 表示无序列表。

<span class="line">1</span> <span class="line">2</span> <span class="line">3</span> 1 2 3 <span class="line">1</span> <span class="line">2</span> <span class="line">3</span>

<span class="line"><span class="bullet">*</span> 无序列表项1</span> <span class="line"><span class="bullet">+</span> 无序列表项2</span> <span class="line"><span class="bullet">-</span> 无序列表项3</span> 1 2 3 <span class="line"><span class="bullet">*</span> 无序列表项1</span> <span class="line"><span class="bullet">+</span> 无序列表项2</span> <span class="line"><span class="bullet">-</span> 无序列表项3</span>

输出结果：

• 无序列表项1

• 无序列表项2

• 无序列表项3

3.2有序列表

使用数字加 . 表示有序列表。

<span class="line">1</span> <span class="line">2</span> <span class="line">3</span> 1 2 3 <span class="line">1</span> <span class="line">2</span> <span class="line">3</span>

<span class="line"><span class="bullet">1.</span> 有序列表项1</span> <span class="line"><span class="bullet">2.</span> 有序列表项2</span> <span class="line"><span class="bullet">3.</span> 有序列表项3</span> 1 2 3 <span class="line"><span class="bullet">1.</span> 有序列表项1</span> <span class="line"><span class="bullet">2.</span> 有序列表项2</span> <span class="line"><span class="bullet">3.</span> 有序列表项3</span>

输出结果：

1. 有序列表项1
2. 有序列表项2
3. 有序列表项3

4.超链接

4.1行内式

<span class="line">1</span> 1 <span class="line">1</span>

<span class="line">[<span class="string">小城故事</span>](<span class="link">https://holob.github.io</span>)</span> 1 <span class="line">[<span class="string">小城故事</span>](<span class="link">https://holob.github.io</span>)</span>

输出结果：
小城故事

4.2参考式

<span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span> <span class="line">5</span> <span class="line">6</span> <span class="line">7</span> 1 2 3 4 5 6 7 <span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span> <span class="line">5</span> <span class="line">6</span> <span class="line">7</span>

<span class="line">我经常去的几个网站[<span class="string">Google</span>][<span class="symbol">1</span>]、[<span class="string">github</span>][<span class="symbol">2</span>]以及[<span class="string">自己的博客</span>][<span class="symbol">3</span>]</span> <span class="line">百度是一个不错的[<span class="string">网站</span>][<span class="symbol">4</span>]。</span> <span class="line"></span> <span class="line">[<span class="symbol">1</span>]:<span class="link">http://www.google.com</span></span> <span class="line">[<span class="symbol">2</span>]:<span class="link">http://www.github.com</span></span> <span class="line">[<span class="symbol">3</span>]:<span class="link">https://holob.github.io</span></span> <span class="line">[<span class="symbol">4</span>]:<span class="link">http://www.baidu.com</span></span> 1 2 3 4 5 6 7 <span class="line">我经常去的几个网站[<span class="string">Google</span>][<span class="symbol">1</span>]、[<span class="string">github</span>][<span class="symbol">2</span>]以及[<span class="string">自己的博客</span>][<span class="symbol">3</span>]</span> <span class="line">百度是一个不错的[<span class="string">网站</span>][<span class="symbol">4</span>]。</span> <span class="line"></span> <span class="line">[<span class="symbol">1</span>]:<span class="link">http://www.google.com</span></span> <span class="line">[<span class="symbol">2</span>]:<span class="link">http://www.github.com</span></span> <span class="line">[<span class="symbol">3</span>]:<span class="link">https://holob.github.io</span></span> <span class="line">[<span class="symbol">4</span>]:<span class="link">http://www.baidu.com</span></span>

输出结果：
我经常去的几个网站Google、github以及自己的博客
百度是一个不错的网站。

4.3自动链接

<span class="line">1</span> 1 <span class="line">1</span>

<span class="line"><span class="bullet">1.</span> <span class="xml"><https://baidu.com></span></span> 1 <span class="line"><span class="bullet">1.</span> <span class="xml"><https://baidu.com></span></span>

输出结果：

1. https://baidu.com

5.引用

<span class="line">1</span> <span class="line">2</span> <span class="line">3</span> 1 2 3 <span class="line">1</span> <span class="line">2</span> <span class="line">3</span>

<span class="line">>Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。</span> <span class="line">>>它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。</span> <span class="line">>>>由于Markdown的轻量化、易读易写特性，并且对于图片，图表、数学式都有支持，许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。</span> 1 2 3 <span class="line">>Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。</span> <span class="line">>>它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。</span> <span class="line">>>>由于Markdown的轻量化、易读易写特性，并且对于图片，图表、数学式都有支持，许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。</span>

输出结果：

Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。

它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

由于Markdown的轻量化、易读易写特性，并且对于图片，图表、数学式都有支持，许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。

6.图片

6.1行内式

<span class="line">1</span> <span class="line">2</span> 1 2 <span class="line">1</span> <span class="line">2</span>

<span class="line">蓝胖子哆啦A梦</span> <span class="line">![<span class="string">蓝胖子哆啦A梦</span>](<span class="link">https://img.holob.cn/images/doraemon.jpg</span>)</span> 1 2 <span class="line">蓝胖子哆啦A梦</span> <span class="line">![<span class="string">蓝胖子哆啦A梦</span>](<span class="link">https://img.holob.cn/images/doraemon.jpg</span>)</span>

输出结果：
蓝胖子哆啦A梦

6.2参考式

同时添加多张图片的时候比较方便。

<span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span> 1 2 3 4 <span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span>

<span class="line">蓝胖子哆啦A梦</span> <span class="line">![<span class="string">蓝胖子哆啦A梦</span>][<span class="symbol">pic</span>]</span> <span class="line"></span> <span class="line">[<span class="symbol">pic</span>]: <span class="link">https://img.holob.cn/images/doraemon.jpg</span></span> 1 2 3 4 <span class="line">蓝胖子哆啦A梦</span> <span class="line">![<span class="string">蓝胖子哆啦A梦</span>][<span class="symbol">pic</span>]</span> <span class="line"></span> <span class="line">[<span class="symbol">pic</span>]: <span class="link">https://img.holob.cn/images/doraemon.jpg</span></span>

输出结果：
蓝胖子哆啦A梦

7.目录

在添加[TOC]的位置自动生成目录。

<span class="line">1</span> 1 <span class="line">1</span>

<span class="line">[TOC]</span> 1 <span class="line">[TOC]</span>

8.表格

表格由 | 、— 和 ：组成。
:— 表示左对齐； —：表示右对齐；:—：表示居中。
注意： 在Hexo博客中使用，表格需要与正文空两行才能正常显示。

<span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span> 1 2 3 4 <span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span>

<span class="line">| 姓名 | 性别 | 年龄 |</span> <span class="line">| :--- | :---: | ---: |</span> <span class="line">| 爸 | 男 | 40 |</span> <span class="line">| 妈 | 女 | 40 |</span> 1 2 3 4 <span class="line">| 姓名 | 性别 | 年龄 |</span> <span class="line">| :--- | :---: | ---: |</span> <span class="line">| 爸 | 男 | 40 |</span> <span class="line">| 妈 | 女 | 40 |</span>

输出结果：

姓名	性别	年龄
爸	男	40
妈	女	40

9.角标

<span class="line">1</span> <span class="line">2</span> 1 2 <span class="line">1</span> <span class="line">2</span>

<span class="line">H<span class="xml"><span class="tag"><<span class="name">sub</span>></span></span>2<span class="xml"><span class="tag"></<span class="name">sub</span>></span></span>O CO<span class="xml"><span class="tag"><<span class="name">sub</span>></span></span>2<span class="xml"><span class="tag"></<span class="name">sub</span>></span></span></span> <span class="line">爆米花<span class="xml"><span class="tag"><<span class="name">sup</span>></span></span>TM<span class="xml"><span class="tag"></<span class="name">sup</span>></span></span></span> 1 2 <span class="line">H<span class="xml"><span class="tag"><<span class="name">sub</span>></span></span>2<span class="xml"><span class="tag"></<span class="name">sub</span>></span></span>O  CO<span class="xml"><span class="tag"><<span class="name">sub</span>></span></span>2<span class="xml"><span class="tag"></<span class="name">sub</span>></span></span></span> <span class="line">爆米花<span class="xml"><span class="tag"><<span class="name">sup</span>></span></span>TM<span class="xml"><span class="tag"></<span class="name">sup</span>></span></span></span>

输出结果：
H₂O CO₂
爆米花^TM

10.代码块

10.1行内代码

使用反引号（~ 键）插入代码。

<span class="line">1</span> 1 <span class="line">1</span>

<span class="line">运行 <span class="code"><pre class="inline:true decode:1 " >hexo clean 1 <span class="line">运行 <span class="code"><pre class="inline:true decode:1 " >hexo clean 清除缓存，运行 hexo g 生成页面。

输出结果：
运行 hexo clean 清除缓存，运行 hexo g 生成页面。

10.2多行代码

使用三个反引号（~ 键）插入多行代码。
注意： 第一行三个反引号后面，输入代码块所使用的语言，实现代码高亮。

<span class="line">1</span> <span class="line">2</span> <span class="line">3</span> 1 2 3 <span class="line">1</span> <span class="line">2</span> <span class="line">3</span>

<span class="line">3个<pre class="inline:true decode:1 " >markdown</span> <span class="line">插入多行代码</span> <span class="line">3个 1 2 3 <span class="line">3个<pre class="inline:true decode:1 " >markdown</span> <span class="line">插入多行代码</span> <span class="line">3个

输出结果：

<span class="line">1</span> 1 <span class="line">1</span>

<span class="line">插入多行代码</span> 1 <span class="line">插入多行代码</span>

10.3缩进式插入多行代码

注意：

• 缩进式插入前方必须有空行
• 缩进 4 个空格或是 1 个制表符（Tab键）
• 一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）

<span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span> 1 2 3 4 <span class="line">1</span> <span class="line">2</span> <span class="line">3</span> <span class="line">4</span>

<span class="line">此处有空行</span> <span class="line"><span class="code"> hexo clean</span></span> <span class="line"><span class="code"> hexo g</span></span> <span class="line"><span class="code"> hexo s</span></span> 1 2 3 4 <span class="line">此处有空行</span> <span class="line"><span class="code">    hexo clean</span></span> <span class="line"><span class="code">    hexo g</span></span> <span class="line"><span class="code">    hexo s</span></span>

输出结果：

11.分割线

连续三个_或者三个*。

<span class="line">1</span> <span class="line">2</span> 1 2 <span class="line">1</span> <span class="line">2</span>

<span class="line"><span class="strong">__<span class="emphasis">_</span></span></span> <span class="line"><span class="emphasis"><span class="strong"><span class="strong">**<span class="emphasis">*</span></span></span></span></span> 1 2 <span class="line"><span class="strong">__<span class="emphasis">_</span></span></span> <span class="line"><span class="emphasis"><span class="strong"><span class="strong">**<span class="emphasis">*</span></span></span></span></span>

输出结果：

---

---

结语

如有错误，敬请指正。
如有侵权，请联系删除。