注: 文章摘自 白老师课堂 - 简书
一、区块标记
区块标记：是指内容独占一块，需前后换行，不和其他标记共处一行的标记
1. 段落
段落：即是一段连续的文字，可包含 * 、空格、换行、tab 等字符。两个段落之间使用空行分隔
示例代码
第一自然段
第二自然段
效果
第一自然段
第二自然段
注意：换行不是分段的标识，空行才是
2. 标题
标题：代表了文章中主题的层次，比如：文章标题使用一级标题，回目名称使用二级标题，小节使用三级标题，依次类推。主题的层次代表了文章的大纲
语法：Markdown 中使用连续 n(1-6) 个 "#" 分别表示第 n 级标题, "#" 和后续内容之间应放置一个空格
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
3. 列表
列表：就是一组相关信息的集合
- 有序列表
语法：使用 "(数字)" 和 "." 作为项目符号，项目符号和正式列表项目之间有一个空格
1. 步骤一
2. 步骤二
3. 步骤三
- 步骤一
- 步骤二
- 步骤三
- 无序列表*
语法：使用 "+" 作为项目符号，项目符号和正式列表项目之间有一个空格
+ 一级目录
+ 二级目录
+ 三级目录
+ 四级目录
+ 一级目录
+ 二级目录
+ 二级目录
+ 三级目录
- 一级目录
- 二级目录
- 三级目录
- 四级目录
注意
- 无序列表的符号可使用 *,+,- 效果是相同的
- 每一层级目录 (第一层级除外) 前面应相对于上一层级添加一个 tab 或两个空格, 以便区分等级
4. 分割线
语法：至少使用 3 个连续的 * 即可得到一个分割线
***
5. 引用
语法：在行头加上 ">" 即可, ">" 和后续内容之间有一个空格
> 引用
引用
- 可以在每行之前加 ">" ，也可以在段落之前加 1 个 ">"
- 引用内部可以使用其他 Markdown 标记
二、行内标记
行内标记和其他标记共处一行
1. 强调文字
- 斜体
语法：内容前后各1个 "*"或"_"
*斜体*
_斜体_
- 粗体
语法：内容前后各2个 "*"或"_"
**粗体**
__粗体__
- 删除文字
语法：内容前后各2个 "~"
~~删除~~
删除
- 粗斜体
语法：内容前后各2个 "" 和1个"_" 或 1个 ""和2个"_" (左右要对称)
_**粗斜体**_
*__粗斜体__*
**_粗斜体_**
__*粗斜体*__
2. 图片
- 行内图片
图片和图片地址写在一起
语法：
[图片上传失败...(image-b2fafa-1534418374184)]
简书 LOGO
- 在简书中，图片可以直接拖到编辑区，会自动上传图片并生成图片地址; 也可以右键 (Ctrl + V) 直接粘贴
- "[]" 方括号里的内容可以不写
- 引用图片
图片和图片地址分开书写
![图片标题][图片 id]
(空行)
[图片 id]:图片 url
![简书 LOGO][jianshu]
[jianshu]:https:https://yqfile.alicdn.com/img_dcb5040cb72f24cf921590c6ad49ae6b.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
- 引用图片的 id 在文章中必须唯一
- 名称和路径之间至少空一行
- 图片名称 (第一对"[]"内容) 可以不写
- 链接 id 可使用字母、数字、空格和下划线等，不区分大小写
3. 链接
- 行内链接
链接和地址写在一起
[链接名称](链接地址 url "链接title")
[小贤笔记](https://www.jianshu.com/u/195a91a868f5)
小贤笔记
- 引用链接
链接和地址分开书写
[链接名称][链接id]
(空行)
[链接id]:链接 url 地址 "链接 title"
[小贤笔记][xxbj]
[xxbj](https://www.jianshu.com/u/195a91a868f5)
- 自动链接
一种简明的链接书写方式
<链接地址>
<https://www.jianshu.com/u/195a91a868f5>
https://www.jianshu.com/u/195a91a868f5
4. 脚注
为名词提供注释，注释将显示在文章末尾
待解释文字[^脚注 id]
[^脚注 id]:注释内容
Hello World[^hello]
[^hello]:你好, 世界
Hello World [1] (第二行的内容在文章最底部)
注意事项
- 脚注 id 必须唯一
- 无论脚注 id 如何起名，显示时一律标为数字，并且按出现顺序排列
- 翻译的内容会自动跳到文章末尾
三、代码块
行内代码块
语法：使用两个 "`"(esc 下面的那个键) 将代码包含起来
`Hello World`
Hello World
多行代码块
语法：只需要每行都缩进 4 个空格即可，或者使用```框起来
- 方法1: 每前面增加两个 tab 或 4个空格
function() {
alert("Hello, world")
}
function() { alert("Hello, world") }
- 方法2: 代码上下用 ```(esc 下面的键) 框起来
... // ← esc 下面的键, 由于显示问题, 这里用 "." 代替
function() {
alert("Hello, world")
}
... // ← esc 下面的键, 由于显示问题, 这里用 "." 代替
- 在代码区块内部，Markdown 标记失效，比如：+ 就是 + ，不被解释为特殊标记
四、表格
- 第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行
- 列于列之间用管道符 "|" 隔开, 表格每一行两边的管道符可省略
- 第二行还可以为不同的列指定对齐方向, 默认为左对齐；在 "-" 左边加上 ":" 就是左对齐；在 "-" 右边加上 ":" 就是右对齐；在 "-" 两边都加上 ":" 就是居中对齐
|姓名|年龄|性别|身高(cm)|
|-|:-|:-:|-:|
|张三|22|男|180|
|李四|18|女|165|
姓名 年龄 性别 身高(cm) 张三 22 男 180 李四 18 女 165
五、其他问题
1. Markdown 与 HTML 的关系
- HTML 是一种发布的格式，Markdown 是一种书写的格式
- Markdown 的格式语法只涵盖纯文本可以涵盖的范围
- 在 Markdown 中可直接使用 HTML 标签，但需要注意
- 对于 HTML 区块元素――如 div、table、pre、p 等标签，必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符(tab)或空格来缩进
- HTML 的行内标签——如 span、cite、del 可以在 Markdown 的段落、列表或是标题里随意使用
- 在 HTML 的区块标签中的 Markdown 标签是没有效果的
2. 特殊字符的自动转换
- 在 HTML 文件中，有两个字符需要特殊处理： < 和 &，必须使用转义字符：& lt ; 和 & amp
- Markdown 中，你可以自由的书写 < 和 &，编辑器会智能的进行判断：当这些符号用于 HTML 标签中，他们将保留原型；当他们单独使用时，将会转换为字符实体
- 在代码块中，它们将统统被转换为字符实体，即原样显示
3. Markdown 中的转义字符
Markdown 中，如需显示有特定意义的符号，如：*,# 等，可使用 反斜杠 \ 进行转义。可对如下字符进行转义：
*
`
*
_
{}
()
#
+
-
.
!
六、简书尚不支持的标记和不足
- 用于生成目录索引的 [TOC]
- 用于说明文章标签的 tags
- 定义列表和待办事宜 Todo 列表
- 数学公式
- 各种图形：流程图、时序图、甘特图
- 其他技术，如：{mermaid}
- 区块代码中不显示行号
- 你好, 世界 ↩
![简书Markdown语法指南[图]](data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs=)