Markdown 支持六个级别的标题。
语法:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题💡 粗体、斜体、删除线可以混合使用。 在 Markdown 中,粗体文本、斜体文本可以使用
*或_符号标记。建议统一风格,始终只用一种符号。
| 语法 | 效果 | 
|---|---|
| 普通文本 | 普通文本 | 
| *斜体文本* _斜体文本_ | 斜体文本 斜体文本 | 
| **粗体文本** __粗体文本__ | 粗体文本 粗体文本 | 
| ~~删除文本~~ | 删除文本 | 
| ***粗斜体文本*** ___粗斜体文本___ | 粗斜体文本 粗斜体文本 | 
*** 、 --- 、 ___ 都可以作为分割线。
语法:
[钝悟的博客](https://dunwu.github.io/blog/)[] 中标记链接名。类似 HTML 中 <a> 元素的 title 属性。() 中标记链接的 url,也支持相对路径(前提是资源可以访问)。类似 HTML 中 <a> 元素的 href 属性。效果:
Markdown 引用图片的语法:
alt 和 title 即对应 HTML 中 img 元素的 alt 和 title 属性(都可省略):
可以将图片和链接混合使用。
其实呢,每一个标题都是一个锚点,和 HTML 的锚点( # )类似,比如:回到顶部
普通引用:
❓ 什么是
MarkdownMarkdown 是一种轻量级标记语言,创始人为约翰・格鲁伯(英语:John Gruber)。它允许人们 “使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者 HTML)文档”。[4] 这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。 —— 摘自 Wiki
嵌套引用:
数据结构 树 二叉树 平衡二叉树 满二叉树
语法:
`Markdown` `Doc`效果:
Markdown , Doc
语法一:在文本前后都使用三个反引号进行标记。【✔️ 推荐】
这是一个文本块。
这是一个文本块。
这是一个文本块。语法二:在连续几行的文本开头加入 1 个 Tab 或者 4 个空格。【❌ 不推荐】
这是一个文本块。
这是一个文本块。
这是一个文本块。在三个反引号后面加上编程语言的名字,另起一行开始写代码,最后一行再加上三个反引号。
public static void main(String[]args){} //Java| int main(int argc, char *argv[]) //C | 
|---|
echo "hello GitHub" #Bash| document.getElementById('myH1').innerHTML = 'Welcome to my Homepage' //javascipt | 
|---|
| string &operator+(const string& A,const string& B) //cpp | 
|---|
一般表格:
| 表头 1 | 表头 2 | 
|---|---|
| 表格单元 | 表格单元 | 
| 表格单元 | 表格单元 | 
表格可以指定对齐方式:
| 序号 | 商品 | 价格 | 
|---|---|---|
| 1 | 电脑 | 6000.0 | 
| 2 | 鼠标 | 100.0 | 
| 3 | 键盘 | 200.0 | 
💡 注意:部分 Markdown 引擎支持 Emoji。
合理使用 Emoji 表情,往往可以使得文章内容更加丰富生动。例如:✔️ ❌ 💡 🔔 ❗️ ❓
更多 Emoji 表情请参考:
💡 注意:部分 Markdown 引擎支持注脚。
一个具有注脚的文本。[1]
💡 注意:部分 Markdown 引擎支持 Latex。
很多文档中,需要引入一些数学符号、特殊符号,其排版问题比较头疼。这种问题,可以用 Latex 来解决,大部分 Markdown 引擎都支持 Latex。
Latex 可以使用 $ 符号来标记 Latex 表达式,下面是一个数学公式示例:
Γ(z)=∫0∞tz−1e−tdt.\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.Γ(z)=∫0∞tz−1e−tdt.
列举一些常用数学符号:
| 符号 | 语法 | 描述 | 
|---|---|---|
| ≤\leq≤ | $\leq$ | 小于等于 | 
| ≥\geq≥ | $\geq$ | 大于等于 | 
| ≠\neq= | $\neq$ | 不等于 | 
| ≈\approx≈ | $\approx$ | 约等于 | 
| ∞\infty∞ | $\infty$ | 无穷 | 
| \prod_{x}^ | $\prod_{x}^{y}$ | 累乘 | 
| ∑i=0n\sum_{i=0}^n∑i=0n | $\sum_{i=0}^n$ | 求和 | 
| ∫\int∫ | $\int$ | 积分 | 
| ∬\iint∬ | $\iint$ | 双重积分 | 
| logx\log_xlogx | $\log_x{y}$ | 对数 | 
| x^ | $x^{y+1}$ | 上标 | 
| x_ | $x_{y+1}$ | 下标 | 
| \frac{x} | $\frac{x}{y}$ | 分数 | 
| \sqrt[y] | $\sqrt[y]{x}$ | 开方 | 
| sin\sinsin | $\sin$ | 正弦 | 
| cos\coscos | $\cos$ | 余弦 | 
| tan\tantan | $\tan$ | 正切 | 
更多数学符号支持请参考:
💡 注意:部分 Markdown 引擎支持 Diff。
版本控制的系统中都少不了 diff 的功能,即展示一个文件内容的增加与删除。
GFM 中可以显示的展示 diff 效果。可以用 + 开头表示新增, - 开头表示删除。
| + 新增内容 | |
|---|---|
| - 删除内容 | 
💡 注意:部分 Markdown 引擎支持 mermaid。 mermaid 提供了多种 UML 图。详情请参考:mermaid 文档
| graph LR | |
|---|---|
| A[Hard edge] -->|Link text| B(Round edge) | |
| B --> C{Decision} | |
| C -->|One| D[Result one] | |
| C -->|Two| E[Result two] | 
| sequenceDiagram | |
|---|---|
| Alice->>Bob: Hello Bob, how are you? | |
| alt is sick | |
| Bob->>Alice: Not so good :( | |
| else is well | |
| Bob->>Alice: Feeling fresh like a daisy | |
| end | |
| opt Extra response | |
| Bob->>Alice: Thanks for asking | |
| end | 
| gantt | |
|---|---|
| dateFormat YYYY-MM-DD | |
| title Adding GANTT diagram functionality to mermaid | |
| section A section | |
| Completed task :done, des1, 2014-01-06,2014-01-08 | |
| Active task :active, des2, 2014-01-09, 3d | |
| Future task : des3, after des2, 5d | |
| Future task2 : des4, after des3, 5d | |
| section Critical tasks | |
| Completed task in the critical line :crit, done, 2014-01-06,24h | |
| Implement parser and jison :crit, done, after des1, 2d | |
| Create tests for parser :crit, active, 3d | |
| Future task in critical line :crit, 5d | |
| Create tests for renderer :2d | |
| Add to mermaid :1d | |
| section Documentation | |
| Describe gantt syntax :active, a1, after des1, 3d | |
| Add gantt diagram to demo page :after a1 , 20h | |
| Add another diagram to demo page :doc1, after a1 , 48h | |
| section Last section | |
| Describe gantt syntax :after doc1, 3d | |
| Add gantt diagram to demo page :20h | |
| Add another diagram to demo page :48h | 
有些 Markdown 引擎支持在文档中嵌入的 html 元素。
有些 Markdown 语法所不支持的特性,可以使用 html 元素来支持。
<details> <summary> 折叠内容一 </summary> <p> 展开才能看到的内容 </p> </details> <details> <summary> 折叠内容二 </summary> <p> 展开才能看到的内容 </p> </details>
<div align="center"><p > 居中显示的文本 </p></div>
<div align="center"><img width="100px" src="https://raw.githubusercontent.com/dunwu/images/dev/common/dunwu-logo.png" /></div>
推荐 Markdown 编辑器
想了解更多 Markdown 编辑器可以参考:主流 Markdown 编辑器推荐