二. 再熟悉 Markdown 标准语法
本文选自 《了不起的Markdown》,作者:毕小烦
本章主要介绍 Markdown 标准语法。
段落与换行
Markdown 语法中的段落由一行或多行文本组成的,不同的段落之间使用空行来标记。
语法说明:
-
如果行与行之间没有空行,则会被视为同一段落;
-
如果行与行之间有空行,则会被视为不同段落;
-
空行是指行内什么都没有,或者只有空格和制表符;
-
如果想在段内换行,则需要在上一行的结尾插入两个以上的空格然后回车;
实例演示:
标题
Markdown 语法中标题支持两种标记:使用底线和使用 # 号。
1. 使用底线
标记语法:
标题内容
=========
标题内容
=========
或
标题内容
--------
标题内容
--------
语法说明:
-
底线是 =(等号) 表示一级标题;
-
底线是 - (减号)表示二级标题;
-
底线的数量不限;
-
这种语法只支持 2 级标题;
实例演示:
2. 使用 # 号
标记语法:
# + 空格 + 标题内容
# + 空格 + 标题内容
语法说明:
-
在行首插入 # 号可标记出标题;
-
# 号的个数表示了标题的等级;
-
建议在 # 号后加一个空格;
-
Markdown 中最多只支持 6 级标题;
实例演示:
列表
Markdown 语法支持有序列表和无序列表,有序列表由数字 + 英文句号 + 空格 + 列表内容标记,无序列表由星号/加号/减号 + 空格 + 列表内容标记。
1. 有序列表
标记语法:
数字 + 英文句号 + 空格 + 列表内容
数字 + 英文句号 + 空格 + 列表内容
实例演示:
2. 无序列表
标记语法:
星号/加号/减号 + 空格 + 列表内容
星号/加号/减号 + 空格 + 列表内容
语法说明:
星号、加号、减号用来标记无序列表效果是相同的。
实例演示:
3. 嵌套列表
标记语法:
+ 第一层列表
TAB + 第二层列表
TAB + TAB + 第三层列表
+ 第一层列表
TAB + 第二层列表
TAB + TAB + 第三层列表
语法说明:
-
列表中可以嵌套列表;
-
有序列表和无序列表也可以互相嵌套;
实例演示:
引用
Markdown 语法中引用由小于号 + 引用内容标记。
标记语法:
> 引用内容
> 引用内容
语法说明:
-
多行引用也可以在每一行的开头都插入 >(小于号);
-
引用中可以嵌套引用;
-
引用中可以使用其他的 Markdown 语法;
-
段落与换行的格式在引用中也是适用的;
演示:
分隔线
Markdown 语法中分隔线由三个以上的星号/减号/下划线来标记。
标记语法:
***
或
---
或
___
***
或
---
或
___
语法说明:
-
分隔线使用至少三个以上的星号/减号/下划线来标记;
-
行内不能有其他的字符;
-
可以在标记符中间加上空格;
实例演示:
本文节选自《Markdown 实用指南》
粗体和斜体
Markdown 语法中粗体由两个**或两个__包裹,斜体由一个*或_包裹。
标记语法:
粗体格式:
**加粗内容**
或
__加粗内容__
**加粗内容**
或
__加粗内容__
斜体格式:
*斜体内容*
或
_斜体内容_
*斜体内容*
或
_斜体内容_
实例演示:
代码
Markdown 中在行内引用一段代码的语法用两个反引号包裹代码来标记的。
标记语法:
`代码`
`代码`
图片
标记语法:
![图片替代文字](图片地址)
![图片替代文字](图片地址)
语法说明:
-
图片替代文字在图片无法正常显示时会比较有用,正常情况下可为空;
-
图片地址可以是本地图片也可以是网络图片;
-
本地图片支持相对路径和绝对路径;
实例演示:
链接
Markdown 支持两种链形式的链接语法:行内式链接和参考式链接。
行内式链接
Markdown 中行内式链接的语法是用方括号包裹链接文字,后面紧跟着括号包裹的链接地址。
标记语法:
[链接文字](链接地址 "Title")
[链接文字](链接地址 "Title")
语法说明:
Title 在链接地址后使用单引号和双引号括起来,可以省略;
实例演示:
参考式链接
Markdown 中参考式链接的语法是通过一个标记把要链接的文字和内容相匹配的。
标记语法:
[链接文字][链接标记]
[链接标记]: 链接地址 "Title"
[链接文字][链接标记]
[链接标记]: 链接地址 "Title"
语法说明:
-
链接标记可以有字母、数字、空白和标点符号;
-
链接标记不区分大小写;
-
链接内容可以放在当前文件的任意位置;
-
Title 在链接地址后使用单引号、双引号或括号包裹起来,可以省略;
实例演示:
自动链接
URL 或邮箱地址使用 <> 包裹起来会被自动转换为超链接。
标记语法:
<URL或邮箱地址>
<URL或邮箱地址>
实例演示:
转义
Markdown 中通过使用 \(反斜杠)来插入一些特殊符号,在 Typora 中的同样支持。
标记语法:
\特殊符号
\特殊符号
语法说明:
Markdown 支持的可被转义的特殊符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
实例演示:
本文节选自《Markdown 实用指南》 作者:毕小烦