Markdown 的目标是实现「易读易写」。
Markdown 语法的目标是:成为一种适用于网络的书写语言。
Markdown 是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。
Markdown 的语法简洁明了、学习容易,而且功能比纯文本更强。
建议使用缩进表示归属上一层级,如果出现块情况非空行不能处理归属问题
标题
|
|
H1 :# Header 1
H2 :## Header 2
H3 :### Header 3
H4 :#### Header 4
H5 :##### Header 5
H6 :###### Header 6
文本样式
|
|
链接 :Title
加粗 :Bold
斜体字 :Italics
删除线 :text
高亮 :==text==
段落 : 段落之间空一行
换行符 : 一行结束时输入两个空格
列表 :* 添加星号成为一个新的列表项。
引用 :> 引用内容
内嵌代码 : alert('Hello World');
画水平线 (HR) :——–
图片
|
|
写代码
|
|
HTML 代码
在 HTML 区块标签间的 Markdown 格式语法将不会被处理。处在 HTML 区块标签间不同,Markdown 语法在 HTML 区段标签间是有效的。
特殊字符自动转换
符号 | 输入 |
---|---|
& | & |
> | > |
< | < |
区块引用 Blockquotes
|
|
This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.Back to the first level.
列表
|
|
- Red
- Green
Light - Blue
|
|
- Bird
- McHale
- Parish
如果列表项目间用空行分开,在输出 HTML 时 Markdown 就会将项目内容用 <p> 标签包起来
当然,项目列表很可能会不小心产生,像是下面这样的写法:
换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠。
表格
|
|
Tables | Col | Type |
---|---|---|
SA_User | Type | int |
SA_Role | RoleName | char |
SA_UserRole | UserId | 1 |
自动链接
|
|
反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em> 标签),可以在星号的前面加上反斜杠:
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号: