Markdown简明语法教程

微风

2019/03/24 发布于 技术 分类

文字内容
1. 目 录 致谢 Markdown简明语法教程 本文档使用 书栈(BookStack.CN) 构建 -1-
2. 致谢 致谢 当前文档 《Markdown简明语法教程》 由 进击的皇虫 使用 书栈(BookStack.CN) 进行构 建,生成于 2018-03-01。 书栈(BookStack.CN) 仅提供文档编写、整理、归类等功能,以及对文档内容的生成和导出工 具。 文档内容由网友们编写和整理,书栈(BookStack.CN) 难以确认文档内容知识点是否错漏。如 果您在阅读文档获取知识的时候,发现文档内容有不恰当的地方,请向我们反馈,让我们共同携手, 将知识准确、高效且有效地传递给每一个人。 同时,如果您在日常生活、工作和学习中遇到有价值有营养的知识文档,欢迎分享到 书栈 (BookStack.CN) ,为知识的传承献上您的一份力量! 如果当前文档生成时间太久,请到 书栈(BookStack.CN) 获取最新的文档,以跟上知识更新换 代的步伐。 文档地址:http://www.bookstack.cn/books/Simple-Markdown-Guide'>http://www.bookstack.cn/books/Simple-Markdown-Guide 书栈官网:http://www.bookstack.cn 书栈开源:https://github.com/TruthHun 分享,让知识传承更久远! 感谢知识的创造者,感谢知识的分享者,也感谢每一位阅读到此处的 读者,因为我们都将成为知识的传承者。 本文档使用 书栈(BookStack.CN) 构建 -2-
3. Markdown简明语法教程 Markdown简明语法教程 Markdown简明语法教程 基本 字体 换行 标题 这是标题 列表 引用 代码区块 链接 - - 特殊符号 推荐阅读 License Markdown简明语法教程 说明: 本教程基于Markdown语言编写,项目地址位于Simple-Markdown-Guide。 本教程定位为基础教程,更加详细的用法可参考其他资料。 本教程中代码块内的代码为Markdown的语法。 本教程中部分语法使用的是GitHub Flavored Markdown,GFM语法与标准语法在不同环境中 存在解析差异,本教程在使用时会加以说明。 推荐使用Haroopad(Win)、MarkdownPad(Win)和Mou(OS X)编辑器,部分编辑器中文效果欠 佳,可通过自定义CSS字体解决。 基本 Markdown是一种用来写作的轻量级标记语言。 用标记语法,来代替常见的排版格式。 兼容 HTML代码。 特殊字符自动转换,例如 < 和 & 。 字体 使用星号 * 和底号 _ 表示 本文档使用 书栈(BookStack.CN) 构建 标签。 -3-
4. Markdown简明语法教程 例如: 1. *斜体* 2. _斜体_ 效果: 斜体 使用双星号 ** 和双底号 __ 表示 标签。 例如: 1. **强调** 2. __强调__ 效果: 强调 换行 单一段落用空白行。 标题 生成

-

标签,是通过在文字前面加上同等个数 # 符号来实现。 出于美观,也可以使用对称的闭合式标题符号。 例如: 1. ### 这是标题 2. ### 这是标题 ### 效果: 这是标题 列表 本文档使用 书栈(BookStack.CN) 构建 -4-
5. Markdown简明语法教程 , * , - + 这三个符号效果都一样,这3个符号被称为Markdown列表符号。而有序列表 则使用数字接着一个英文句点(数字大小并不会影响输出序列)。 例如: 1. * 第一行 2. * 第二行 3. * 第三行 4. 6. 第四行 5. 5. 第五行 6. 4. 第六行 效果: 第一行 第二行 第三行 i. 第四行 ii. 第五行 iii. 第六行 引用 符号表示引用,可简写于第一行,也可以每一行都添加。 > 区块的引用可以嵌套,只需要在层次数上加上同等数量的 > 符号。 引用内可以使用其他Markdown语法,包括标题、列表、代码区块等。 例如: 1. > 引用 2. > > 引用中的引用 效果: 引用 引用中的引用 代码区块 ` 的 是表示inline代码,4个
 (空格)来表示缩进式代码段,分别对应HTML 标签。也可以使用 本文档使用 书栈(BookStack.CN) 构建 ``` 来表达围栏式代码块(GFM语法,部分编辑器不 -5- 
6. Markdown简明语法教程 支持),并指定他的语言类型,实现语法高亮。围栏式代码块可以大量减少缩进的使用,大规模 的代码块使用非常方便。 例如: 1. `sort()` 函数按升序对给定数组的值排序。 普通的缩进式代码块。 1. 'Dog', 'b' => 'Cat'); 3. sort($my_array); 4. 5. print_r($my_array); ?> 带语法高亮的围栏式代码块(GFM语法,部分编辑器不支持)。 1. ```php 2. 'Dog', 'b' => 'Cat'); 4. sort($my_array); 5. print_r($my_array); 6. ?> 7. ``` 效果: 函数按升序对给定数组的值排序。 sort() 普通的缩进式代码块。 1. 'Dog', 'b' => 'Cat'); 3. sort($my_array); 4. print_r($my_array); 5. ?> 带语法高亮的围栏式代码块(GFM语法,部分编辑器不支持)。 1. 'Dog', 'b' => 'Cat'); 3. sort($my_array); 4. print_r($my_array); 5. ?> 本文档使用 书栈(BookStack.CN) 构建 -6-
7. Markdown简明语法教程 链接 Markdown支持两种形式的链接语法:行内式和参考式两种形式。 行内式链接,是在方括号后面接圆括号即可。 例如: 1. [Melo618](http://melo618.com'>http://melo618.com "Melo618的博客") 效果: Melo618 参考式链接,是在链接文字的括号后面加上另一个方括号,在第二个方括号里面要填入用以辨识 链接的标记。 例如: ``` Melo618 1. 2. 效果: 3. 4. [Melo618][blog] 5. [blog]: http://melo618.com'>http://melo618.com "Melo618的博客" 6. 7. ## 图片 8. 9. * Markdown使用一种和链接很相似的语法来标记图片,只是多了一个`!`在最前面,同样也允许两种样式:行内式和参考式。 10. * 目前为止,Markdown还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的``标签。 11. 12. 行内式链接,是在方括号后面接圆括号即可。 13. 例如: 本文档使用 书栈(BookStack.CN) 构建 -7-
8. Markdown简明语法教程 1. 2. 效果: 3. 4. ![微信](http://7sbovo.com1.z0.glb.clouddn.com/simple-markdown-guide-weixin.png'>http://7sbovo.com1.z0.glb.clouddn.com/simple-markdown-guide-weixin.png "微信") 5. 6. 参考式链接,是在链接文字的括号后面加上另一个方括号,在第二个方括号里面要填入用以辨识链接的标记。 7. 例如: 1. 2. 效果: 3. 4. ![微信][QR] 5. [QR]: http://7sbovo.com1.z0.glb.clouddn.com/simple-markdown-guide-weixin.png'>http://7sbovo.com1.z0.glb.clouddn.com/simple-markdown-guide-weixin.png "微信" 6. 7. ## 分隔线 8. 9. * 使用三个以上的`*`、`-`来建立一个分隔线,行内不能有其他字符。 10. 11. 例如: 本文档使用 书栈(BookStack.CN) 构建 -8-
9. Markdown简明语法教程 - - 1. 2. 效果: 3. 4. 上文 5. - - - 6. 下文 7. 8. ## 表格 9. 10. * Markdown使用` `和`-`来绘制表格,`:`可控制左对齐、右对齐及居中。 11. 12. 例如: Title Description Version 0.0.1 Editor Melo618 ``` 效果: Title Description Version 0.0.1 Editor Melo618 特殊符号 Markdown利用 \ 字符来转义一些在语法中有特殊意义的符号。 推荐阅读 Markdown语法说明(简体中文版) Markdown Syntax Documentation GitHub Flavored Markdown 本文档使用 书栈(BookStack.CN) 构建 -9-
10. Markdown简明语法教程 License Copyright © 2014-2015, Melo Chan. MIT License. 本文档使用 书栈(BookStack.CN) 构建 - 10 -