Markdown 极简教程


本文介绍 Markdown 的基础语法,内容简洁清晰,便于快速掌握,可满足日常大部分使用需求。此外,Markdown 存在多种扩展方言,不同渲染引擎的输出结果也有所差异。本文以 GitHub Flavored Markdown(简称 GFM) 为标准,并以 GitHub 的渲染效果作为示例。

Block 块级元素

标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

建议:一篇 Markdown 文档应仅包含一个一级标题,标题层级应保持连续 (避免从 H1 直接跳至 H3)


换行与段落

这里的换行
不生效,会和下一行连在一起。

上面的两个换行 (即一个空行) 会产生一个新段落,起到分段作用。若需换行,可以这样操作:\
此外,在需要手动换行的场景中,可考虑使用列表替代。

建议:段落间用空行分隔,避免连续两个以上换行符

引用

> 漢學家稱這個空白字元為「盤古之白」,因為它劈開了全形字和半形字之間的混沌。另有研究顯示,打字的時候不喜歡在中文和英文之間加空格的人,感情路都走得很辛苦,有七成的比例會在 34 歲的時候跟自己不愛的人結婚,而其餘三成的人最後只能把遺產留給自己的貓。畢竟愛情跟書寫都需要適時地留白。

建议:引用后空一行,增强可读性


有序列表

1. 第一项
2. 第二项
    1. 嵌套子项 (缩进 4 空格)
    2. 嵌套子项 (缩进 4 空格)

无序列表

- 第一项
- 第二项
  - 嵌套子项 (缩进 2 空格)
  - 嵌套子项 (缩进 2 空格)


任务列表

- [x] 第一项
- [ ] 第二项
  - [x] 嵌套子项 (缩进 2 空格)
  - [ ] 嵌套子项 (缩进 2 空格)

分割线

---

表格

| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 内容   |   内容   |   内容 |


Inline 行级元素

链接、自动链接

[显示文本](https://example.com)
自动链接:<https://example.com>

图片

![Slidev](https://cn.sli.dev/logo-title.png)

建议:优先使用图床管理图片,而不是把图片和 Markdown 文档放在一起。

加粗、斜体、删除线

- **加粗**
- *斜体*
- ~~删除~~


代码

行内代码

使用 `console.log()` 示例

代码块

```javascript
function hello() {
  console.log("Hello World");
}
```

建议:指定语言类型可触发语法高亮


数学公式

行内公式

公式 $E=mc^2$ 在行内显示

公式块

$$
\begin{bmatrix}
1& 0\\
0& 1
\end{bmatrix}
$$

相关推荐