Markdown语法 发布于 · 2022-06-11 · # 默认分类 # 一.分级目录 **语法：** * 总目录 * 一级目录 * 二级目录 * 三级目录 说明：层级列表一般只支持三级列表，第一级实心圆点，第二级空心圆点，第三级以后都是实心方点。要实现层级列表，每下一级都要比上一级多输入2个空格或者一个Tab，而且第一级前面不要超过3个空格. **展示效果：** * 总目录 * 一级目录 * 二级目录 * 三级目录 # 二.斜体与粗体 **语法：** *斜体* **粗体** **展示效果：** *斜体* **粗体** # 三.超链接 Markdown支持两种形式的链接语法：行内式和参考式，行内式一般用的比较多。 ## 3.1.行内式： **语法：** [打开百度](http://www.baidu.com) [打开百度](http://www.baidu.com "打开百度") 说明:[]里写链接文字，()里写链接地址, ()中的”“中可以为链接指定title属性，title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。[链接文字](链接地址 “链接标题”)这样的形式。链接地址与链接标题前有一个空格。 **展示效果：** [打开百度](http://www.baidu.com) [打开百度](http://www.baidu.com "打开百度") ## 3.2.参考式: 参考式超链接一般用在学术论文上面，或者另一种情况，如果某一个链接在文章中多处使用，那么使用引用 的方式创建链接将非常好，它可以让你对链接进行统一的管理。 **语法：** 我经常浏览的几个网站[Google][1]、[Baidu][2]、[51CTO][3]和看视频的网站[爱奇艺][4]感觉都是很不错的网站. [1]:http://www.google.com "google" [2]:http://www.baidu.com "Baidu" [3]:http://www.51cto.com "51cto" [4]:http://www.aiqiyi.com "aiqiyi" **展示效果：** 我经常浏览的几个网站[Google][1]、[Baidu][2]、[51CTO][3]和看视频的网站[爱奇艺][4]感觉都是很不错的网站. [1]:http://www.google.com "google" [2]:http://www.baidu.com "Baidu" [3]:http://www.51cto.com "51cto" [4]:http://www.aiqiyi.com "aiqiyi" ## 3.3.自动连接： **语法：** <http://www.baidu.com/> <admin@baidu.com> 说明：Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用<>包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。 **展示效果：** <http://www.baidu.com/> <admin@baidu.com> # 四.锚点 网页中，锚点其实就是页内超链接，也就是链接本文档内部的某些元素，实现当前页面中的跳转。比如我这里写下一个锚点，点击回到目录，就能跳转到目录。 在目录中点击这一节，就能跳过来。还有下一节的注脚。这些根本上都是用锚点来实现的。 注意：Markdown Extra 只支持在标题后插入锚点，其它地方无效 ## 4.1.页内超链接: **语法：** # 1.分级目录{#index} 跳转到[标题]{#index} > 说明：在你准备跳转到的指定标题后插入锚点{#标记}，然后在文档的其它地方写上连接到锚点的链接。此处使用的是GitHub风格的Markdown语法所以无法正常显示效果，推荐使用以下4.2.文章内部标题链接。 **展示效果：** 跳转到[一.分级目录]{#一.分级目录} > 说明：这里是在本文的分级目录设置的，不然效果不明显 ## 4.2.文章内部标题链接： **语法：** ``` * [目录1](#40) * [标题1](#41) * [标题2](#42) * [标题3](#43) * [标题4](#44) <h3 id="41">标题1</h3> 轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。 <h3 id="42">标题2</h3> 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。 <h3 id="43">标题3</h3> 我轻轻的招手， 作别西天的云彩。 <h3 id="44">标题4</h3> 作别西天的云彩。 ``` **展示效果：** * [目录1](#40) * [标题1](#41) * [标题2](#42) * [标题3](#43) * [标题4](#44) <h3 id="41">标题1</h3> 轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。 <h3 id="42">标题2</h3> 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。 <h3 id="43">标题3</h3> 我轻轻的招手， 作别西天的云彩。 <h3 id="44">标题4</h3> 作别西天的云彩。 # 五.列表 ## 5.1.无序列表: > 使用 *，+，- 表示无序列表 **语法：** - 无序列表一 + 无序列表二 * 无序列表三 **展现效果：** - 无序列表一 + 无序列表二 * 无序列表三 ## 5.2.有序列表： > 有序列表则使用数字接着一个英文句点接一个空格再接内容 **语法：** 1. 有序列表一 2. 有序列表二 3. 有序列表三 **展现效果：** 1. 有序列表一 2. 有序列表二 3. 有序列表三 ## 5.3.定义型列表: **语法：** 名词1 : 定义 1（左侧有一个可见的冒号和四个不可见的空格） 代码块 2 : 这是代码块的定义（左侧有一个可见的冒号和四个不可见的空格） 代码块（左侧有八个不可见的空格） > 说明：定义型列表由名词和解释组成。一行写上定义，紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab) **展现效果：** 名词1 : 定义 1（左侧有一个可见的冒号和四个不可见的空格） 代码块 2 : 这是代码块的定义（左侧有一个可见的冒号和四个不可见的空格） 代码块（左侧有八个不可见的空格） ## 5.4.列表缩进： **语法：** * 轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。 那河畔的金柳， 是夕阳中的新娘； 波光里的艳影， 在我的心头荡漾。 软泥上的青荇， 油油的在水底招摇； 在康河的柔波里， 我甘心做一条水草！ * 那榆荫下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻间， 沉淀着彩虹似的梦。 但我不能放歌， 悄悄是别离的笙箫； 夏虫也为我沉默， 沉默是今晚的康桥！ 悄悄的我走了， 正如我悄悄的来； 我挥一挥衣袖， 不带走一片云彩。 > 说明：列表项目标记通常是放在最左边，但是其实也可以缩进，最多 3 个空格，项目标记后面则一定要接着至少一个空格或制表符。 **展现效果：** * 轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。 那河畔的金柳， 是夕阳中的新娘； 波光里的艳影， 在我的心头荡漾。 软泥上的青荇， 油油的在水底招摇； 在康河的柔波里， 我甘心做一条水草！ * 那榆荫下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻间， 沉淀着彩虹似的梦。 但我不能放歌， 悄悄是别离的笙箫； 夏虫也为我沉默， 沉默是今晚的康桥！ 悄悄的我走了， 正如我悄悄的来； 我挥一挥衣袖， 不带走一片云彩。 ## 5.5.包含段落的列表: **语法：** * 轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。 那河畔的金柳， 是夕阳中的新娘； 波光里的艳影， 在我的心头荡漾。 软泥上的青荇， 油油的在水底招摇； 在康河的柔波里， 我甘心做一条水草！ 那榆荫下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻间， 沉淀着彩虹似的梦。 寻梦？撑一支长篙， 向青草更青处漫溯； 满载一船星辉， 在星辉斑斓里放歌。 但我不能放歌， 悄悄是别离的笙箫； 夏虫也为我沉默， 沉默是今晚的康桥！ * 悄悄的我走了， 正如我悄悄的来； 我挥一挥衣袖， 不带走一片云彩。 > 说明： 列表项目可以包含多个段落，每个项目下的段落都必须缩进 4 个空格或是 1 个制表符（显示效果与代码一致）：如果你每行都有缩进，看起来会看好很多，当然，再次地，如果你很懒惰，Markdown 也允许 **展现效果：** * 轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。 那河畔的金柳， 是夕阳中的新娘； 波光里的艳影， 在我的心头荡漾。 软泥上的青荇， 油油的在水底招摇； 在康河的柔波里， 我甘心做一条水草！ 那榆荫下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻间， 沉淀着彩虹似的梦。 寻梦？撑一支长篙， 向青草更青处漫溯； 满载一船星辉， 在星辉斑斓里放歌。 但我不能放歌， 悄悄是别离的笙箫； 夏虫也为我沉默， 沉默是今晚的康桥！ * 悄悄的我走了， 正如我悄悄的来； 我挥一挥衣袖， 不带走一片云彩。 ## 5.6.任务列表: > 要创建任务列表，前缀列表项[ ]。要将任务标记为完整，请使用[x] **语法：** - [ ] 跑步 - [ ] 骑车 - [x] 吃饭 - [ ] 睡觉 **展现效果：** - [ ] 跑步 - [ ] 骑车 - [x] 吃饭 - [ ] 睡觉 # 六.表格 ## 6.1.竖杠|下划线-写法: > 使用竖杠|下划线-写法 **语法：** |名字|性别|年龄|国籍| |---|----|----|---| |张三|男|23|中国| |小红|女|18|中国| |Tom|男|46|美国| **展现效果：** |名字|性别|年龄|国籍| |---|----|----|---| |张三|男|23|中国| |小红|女|18|中国| |Tom|男|46|美国| ## 6.2.html写法: **语法** ``` <table> <tr> <td>车次</td> <td>开车时间</td> <td>到达时间</td> </tr> <tr> <td>D110</td> <td>10:22</td> <td>11:00</td> </tr> </table> ``` **展现效果：** <table> <tr> <td>车次</td> <td>开车时间</td> <td>到达时间</td> </tr> <tr> <td>D110</td> <td>10:22</td> <td>11:00</td> </tr> </table> # 七.创建和突出显示代码块 ## 7.1.栅栏代码块: **语法：** ``` function test() { console.log（“在此函数之前注意空白行?"); } ``` **展现效果：** ``` function test() { console.log（“在此函数之前注意空白行?"); } ``` ## 7.2.语法高亮显示: > 高亮需要解析支持才有效果 **语法：** ```ruby require 'redcarpet' markdown = Redcarpet.new("Hello World!") puts markdown.to_html ``` **展现效果：** > ruby语法： ```ruby require 'redcarpet' markdown = Redcarpet.new("Hello World!") puts markdown.to_html ``` > python语法： ```python def foo(): if not bar: return True ``` ## 7.3.引用代码: > 您可以使用单个反引号来调用句子中的代码或命令。反引号内的文本将不被格式化。 **语法：** Use `git status` to list all new or modified files that haven't yet been committed. **展现效果：** Use `git status` to list all new or modified files that haven't yet been committed. ## 7.4.引用文字: > 你可以用引用文本> **语法：** In the words of Abraham Lincoln: > Pardon my French **展现效果：** In the words of Abraham Lincoln: > Pardon my French ## 7.5.删除线: **语法：** ~~This was mistaken text~~ **展现效果：** ~~This was mistaken text~~