Markdown语法规则(个人备忘录)
语法
这部分内容列出了 John Gruber 定义的 Markdown 语法,包括:
- 段落与换行
- 标题
- 引用
- 列表
- 代码
- 分隔线
- 超链接
- 图像
- 强调
- 字符转义
段落与换行
1. 段落的前后必须是空行:
空行指的是行内什么都没有,或者只有空白符(空格或制表符)
相邻两行文本,如果中间没有空行 会显示在一行中(换行符被转换为空格)、
2. 如果需要在段落内加入换行(<br>):
可以在前一行的末尾加入至少两个空格
然后换行写其它的文字
3. Markdown 中的多数区块都需要在两个空行之间.
标题
1. Setext 形式
H1
====
H2
----
H1
H2
= 和 - 的数量是没有限制的。通常的做法是使其和标题文本的长度相同,这样看起来比较舒服。或者可以像我一样,用四个 - 或 =。
Setext 形式只支持 h1 和 h2 两种标题。
2. atx 形式
① 可以用对称的 # 包括文本:
1 | #### H4 #### |
H4
H5
② 也可以只在左边使用 #:
1 | #### H4 |
H4
H5
③ 成对的 # 左侧和只在左边使用的 # 左侧都不可以有任何空白,但其内侧可以使用空白。
1 | ###左侧使用了空格### |
左侧使用了空格
内侧使用了空格
在这一点上,可能各种 Markdown 的实现会有不同的结果,不过仍然需要我们遵守语法规则。