Markdown语法教程

下载 0

kayky

发布于

771

人观看

#信息技术

用来写作的轻量级标记语言markdown的语法教程，本书介绍了Markdown的基本语法并附有相关代码用于练习

展开查看详情

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 书栈开源：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代码。特殊字符自动转换，例如 < 和 & 。字体使用星号 * 和底号 _ 表示 <em> 标签。本文档使用书栈(BookStack.CN) 构建 - 3 -

4 .Markdown简明语法教程例如： 1. *斜体* 2. _斜体_ 效果：斜体使用双星号 ** 和双底号 __ 表示 <strong> 标签。例如： 1. **强调** 2. __强调__ 效果：强调换行单一段落用空白行。标题生成 <h1> - <h6> 标签，是通过在文字前面加上同等个数 # 符号来实现。出于美观，也可以使用对称的闭合式标题符号。例如： 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 的 <code> ， <pre> 标签。也可以使用 ``` 来表达围栏式代码块（GFM语法，部分编辑器不本文档使用书栈(BookStack.CN) 构建 - 5 -

6 .Markdown简明语法教程支持），并指定他的语言类型，实现语法高亮。围栏式代码块可以大量减少缩进的使用，大规模的代码块使用非常方便。例如： 1. `sort()` 函数按升序对给定数组的值排序。普通的缩进式代码块。 1. <?php 2. $my_array = array('a' => 'Dog', 'b' => 'Cat'); 3. sort($my_array); 4. print_r($my_array); 5. ?> 带语法高亮的围栏式代码块（GFM语法，部分编辑器不支持）。 1. ```php 2. <?php 3. $my_array = array('a' => 'Dog', 'b' => 'Cat'); 4. sort($my_array); 5. print_r($my_array); 6. ?> 7. ``` 效果： sort() 函数按升序对给定数组的值排序。普通的缩进式代码块。 1. <?php 2. $my_array = array('a' => 'Dog', 'b' => 'Cat'); 3. sort($my_array); 4. print_r($my_array); 5. ?> 带语法高亮的围栏式代码块（GFM语法，部分编辑器不支持）。 1. <?php 2. $my_array = array('a' => 'Dog', 'b' => 'Cat'); 3. sort($my_array); 4. print_r($my_array); 5. ?> 本文档使用书栈(BookStack.CN) 构建 - 6 -

7 .Markdown简明语法教程链接 Markdown支持两种形式的链接语法：行内式和参考式两种形式。行内式链接，是在方括号后面接圆括号即可。例如： 1. [Melo618](http://melo618.com "Melo618的博客") 效果： Melo618 参考式链接，是在链接文字的括号后面加上另一个方括号，在第二个方括号里面要填入用以辨识链接的标记。例如： ``` Melo618 1. 2. 效果： 3. 4. [Melo618][blog] 5. [blog]: http://melo618.com "Melo618的博客" 6. 7. ## 图片 8. 9. * Markdown使用一种和链接很相似的语法来标记图片，只是多了一个`!`在最前面，同样也允许两种样式：行内式和参考式。 10. * 目前为止，Markdown还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的`<img>`标签。 11. 12. 行内式链接，是在方括号后面接圆括号即可。 13. 例如：本文档使用书栈(BookStack.CN) 构建 - 7 -

8 .Markdown简明语法教程 1. 2. 效果： 3. 4. ![微信](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 "微信" 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 -

0点赞

0收藏

0下载