Markdown介绍
Markdown介绍
Markdown是一种轻量级的标记语言。主要用于写出带有格式的文档。有点类似于HTML语言,但是语法要比HTML语言简单,十分适合书写文档。而且现在大部分博客和文章输入系统都支持这种语法。例如有道笔记和印象笔记等等。在Github上写的REAME.md就是这种语法写出来的说明文档。而且会在Github上直接显示出带有格式的文档结果。
Markdown优点
- 专注于文字内容,提供简单的排版语法。排版语法可以和文字内容融合。
- 很多的文字编辑工具支持这种语法。包括Atom,IDE,有道笔记,Evernote和博客网站。
- 容易学习,语法简单。
- 可以导出HTML,PDF文件
- 使用Word软件写出的文档无法记录修改的内容,而md文件可以使用Git软件记录更改的内容。追溯修改的过程。
- 扩展部分可以支持流程图,复杂的数学公式使用文字来描述。
Markdown语法
标题
Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
Setext形式标题
类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),例如:
This is an H1
=============
This is an H2
-------------
Atx形式标题
文章的标题格式是最左侧加上#
符号,之后有一个空格,最后右侧写上标题内容。一个井号代表一级标题,两个井号代表二级标题,以此类推,一共有6级。
# 这是 H1
## 这是 H2
###### 这是 H6
列表
无序列表
无序列表使用星号、加号或是减号作为列表标记. 例如:
* Red
* Green
* Blue
或者
+ Red
+ Green
+ Blue
等同于:
- Red
- Green
- Blue
有序列表
有序列表是指在列表的每一行前面带有1, 2, 3...数字。这种列表需要在每一行文字前面增加数字+点的方式。例如"1."。然后再接文字。
引用
Markdown 标记区块引用是使用类似 email 中用 >
的引用方式。使用大于号在文字前面。
区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >
。
图片
图片是在一个对图片的连接,而不是能嵌入图片。有点像html的img标签的src属性。具体的写法为:![Alt text](image_url)
链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。不管是哪一种,链接文字都是用 [方括号] 来标记。
行内参
格式为: [an example](http://example.com/ "Title")
.
一般简写成[an example](http://example.com/)
参考式
参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:
This is [an example][id] reference-style link.
然后在下面的参考位置定义ID的值:
[id]: http://example.com/ "Optional Title Here"
链接网址也可以用尖括号包起来。
[id]: <http://example.com/> "Optional Title Here"
隐式链接标记
隐式链接标记功能让你可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面加上一个空的方括号,如果你要让 "Google" 链接到 google.com,你可以简化成:
[Google][]
然后定义链接内容:
[Google]: http://google.com/
链接的定义可以放在文件中的任何一个地方,我比较偏好直接放在链接出现段落的后面,你也可以把它放在文件最后面,就像是注解一样。
粗体
使用两个**
和两个下划线围绕文字的左右侧。
斜体
使用*
和一个下划线围绕文字的左右侧。
注意: 如果你的 *
和 _
两边都有空白的话,它们就只会被当成普通的符号。
表格
格式如下
| 列表头1 | 列表头2 | 列表头3 |
| ------------- |:-------------:| --------:|
| 内容1 | 内容2 | 内容3 |
| 内容1 | 内容2 | 内容3 |
上面的:
代表对齐的方式。如果冒号两边都有那么代表居中对齐。
代码框。
代码框是程序员写的文档经常用到的。格式有多种,一种是使用单个反引号(一般在键盘的左侧tab键的上面),把代码包围起来。还有一种使用三个反引号把代码包围起来。如果代码是多行的,建议使用三个反引号比较好,其还可以指定代码的类型,例如是Python代码,或者HTML代码,这样显示的效果可以带有语法高亮。
分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。
转义字符
Markdown语法使用的字符如何与你写的文档中的字符有冲突,那么可以使用\
来转义Markdown的字符,变成普通的文字符号。
Markdown提供对如下字符的转义:
\ backslash
` backtick
* asterisk
_ underscore
{} curly braces
[] square brackets
() parentheses
# hash mark
+ plus sign
- minus sign (hyphen)
. dot
! exclamation mark
特殊字符
Markdown兼容HTML中一些特殊字符写法。例如版权符号使用@copy
;
参考: