个人详细介绍: 无
Markdown 语法快速入门
Markdown 是一种轻量级标记语言,能将文本换成有效的XHTML(或者HTML)文档,它的目标是实现易读易写,成为一种适用于网络的书写语言。 Markdown 语言简单明了,易于掌握,所以用它来写作是件既效率又舒服的事情。我们所熟知的一些大型CMS,如Joomla、Drupal等都能很好的支持Markdown。我是因为写GitHub项目库中的Readme才开始接触Markdown。 Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。 Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来, HTML 已经很容易写了。 Markdown 的理念是,能让文档更容易读、写和随意改。 Markdown 是一种书写的格式,HTML 是一种发布的格式。 Markdown 的格式语法只涵盖纯文本可以涵盖的范围。
1 2 3 4 5 6 # H1 ## H2 ### H3 #### H4 ##### H5 ###### H6
另外,H1和H2还能用以下方式显示:
Emphasis 文本强调 1 2 3 *斜体* or _强调_ **加粗** or __加粗__ ***粗斜体*** or ___粗斜体__
但是,如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号: 这是一段 *文本强调* 的说明示例。 如果要在文字前后直接插入普通的星号或底线,你可以用反斜杠(转义符): \*这是一段被星号包围的文字\*
Lists 列表 Unordered 无序列表
1 2 3 4 5 6 7 8 9 10 11 12 13 * 无序列表子项1* 无序列表子项2* 无序列表子项3+ 无序列表子项1+ 无序列表子项2+ 无序列表子项3- 无序列表子项1- 无序列表子项2- 无序列表子项3
Ordered 有序列表
1 2 3 4 5 6 7 8 1. 有序列表子项12. 有序列表子项23. 有序列表子项31. 有序列表子项1- 有序列表子项2- 有序列表子项3
组合
1 2 3 4 5 6 7 8 9 10 11 12 13 14 * 产品介绍(子项无项目符号) 此时子项要以一个制表符 或者 4个空格 缩进 * 产品特点 1. 特点1 2. 特点2 3. 特点3 * 产品功能 1. 功能1 - 功能2 - 功能3
可有时我们会出现这样的情况,首行内容是以日期或数字开头: 2019. 公司年度目标。 为了避免也被转化成有序列表,我们可以在”.”前加上反斜杠(转义符): 2019\. 公司年度目标。
Links 链接(title为可选项) inline-style 内嵌方式
1 2 3 4 5 6 7 8 9 10 11 语法: [link-text](url-link "optional-tips") 解释: link-text:显示的链接文本 url-link:url链接 optional-tips:当鼠标放在 link-text 上显示的提示 示例: [Markdown快速入门](https://www.yuque.com/xiaokongping/md/quick-start "Markdown快速入门")
Reference-style 引用方式
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 语法: [link-text][reference-id] [reference-id]:url-link "optional-tips" (在同一个文件的其它段落定义) 解释: link-text: 显示的链接文本 reference-id: 链接的ID optional-tips:当鼠标放在 link-text 上显示的提示 示例: [百度搜索][baidu] [baidu]:www.baidu.com "使用百度进行搜索" 注意: [link-text][reference-id] 与 [reference-id]:url-link "optional-tips" 之间要至少有一行的的间距
Email 邮件
1 <mazhili1991@ailiyun.com >
Images 图片 inline-style 内嵌方式
1 
Reference-style 引用方式
1 2 3 ![替代文字 ][logo ] [logo ]: http://statics.w3cschool.cn/images/w3c/index-logo.png "标题文字"
Code and Syntax Highlighting 代码和语法高亮 标记一小段行内代码
1 2 3 4 5 语法: `这是被包裹的文字` 示例: 不是因为寂寞才想你,只是因为`想你`才寂寞。
如果高亮的内容包含 ` 号,可以这样写
**语法高亮:**
html代码
1 2 ```html <div>Syntax Highlighting</div>
1 2 3 4 5 6 css代码 ```markdown ```css body { font-size: 12px; }
1 2 3 4 5 JavaScript代码 ```markdown ```javascript let s = 'JavaScript syntax highlighting' alert(s)
1 2 3 4 5 6 php代码 ```markdown ```php <?php echo 'Hello, World!' ?>
1 2 3 4 5 python代码 ```markdown ```python s = Python syntax highlighting print s
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 <br /> <a name="Oi5PU"></a> ## Block Code 代码分组(代码区块) --- Blockquotes 引用,在该行开头缩进4个空格或一个制表符(tab) ```markdown > Email-style angle brackets > are used for blockquotes. > > And, they can be nested. > #### Headers in blockquotes > * You can quote a list. > * Etc.
Hard Line Breaks 换行 在一行的结尾处加上2个或2个以上的空格,也可以使用 标签
1 2 3 4 5 6 第一行文字 第二行文字 或者 第一行文字<br > 第二行文字
Horizontal Rules 水平分割线 三种方式添加水平分割线
1 2 3 4 5 6 7 8 1: *** 2: * * * 3: - - -
Escape character 转义符(反斜杠) Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果,你可以在星号的前面加上反斜杠
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
1 2 3 4 5 6 7 8 9 10 11 12 \反斜杠 `反引号 *星号 _下划线 {}花括号 []方括号 ()括弧 #井字号 +加号 -减号 .英文句 !感叹号
Addtional 补充: Markdown也支持传统的HTML标签。 比如一个链接,你不太喜欢Markdown的写法,也可以直接写成:
1 <a href ="https://www.baidu.com" > 百度一下</a >
附录 Markdown 官网:http://daringfireball.net/projects/markdown/ 参考资料:https://markdown.tw/ Markdown 在线编辑器: