6级标题

txt复制
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

强调（粗体、斜体、删除线）

txt复制
*斜体*        _斜体_
**粗体**      __粗体__
***粗斜体***  ___粗斜体___
~~删除线~~
<u>下划线</u>

效果依次是：斜体、粗体、粗斜体、删除线、下划线。

两点常见坑：

  • 原生 Markdown 没有下划线语法，只能借用 HTML 的 <u>。
  • _ 夹在单词中间不生效（snake_case_name 会原样显示），所以中文混排时优先用 *。
  • 星号内侧留空格会失效：** 粗体 ** 只会显示星号本身。

标题（另一种写法：Setext）

txt复制
一级标题
========
 
二级标题
--------
  • 用 === 或 --- 划在文字下方，只能表示一级、二级。
  • 正文中单独一行 --- 会被当成分割线，注意区分。

强调（粗体 / 斜体 / 删除线 / 高亮）

txt复制
*斜体*        _斜体_
**粗体**      __粗体__
***粗斜体***
~~删除线~~
==高亮==
  • _下划线_ 夹在单词内部时（如 snake_case）不生效，安全起见用 *。
  • ==高亮== 属于扩展语法，不是所有渲染器都支持。
  • 中文加粗时 ** 与文字之间不要留空格，否则可能不解析。

段落与换行

txt复制
第一段文字。
 
第二段文字。（上面空一行）
 
同一段内，行尾留两个空格  
这里被强制换行，但仍属于同一段。
  • 段落之间空 一行 即可；连续多个空行会被合并成一个。
  • 行尾 两个空格 或 一个反斜杠 \ 表示软换行，效果等于 <br>。
  • 行尾只留一个空格无效。

列表

无序列表

txt复制
- 第一项
- 第二项
  - 嵌套项（缩进 2 或 4 个空格）
  - 另一项
- 第三项

-、*、+ 都可以，但同一列表里最好统一。

有序列表

txt复制
1. 第一项
2. 第二项
3. 第三项
  • 序号的具体数字不影响结果，渲染器会自己递增。
  • 中间想插入非列表内容，需要空行 + 缩进。

嵌套与混合

txt复制
1. 有序项
   - 无序子项
     1. 再下一层
2. 有序项

从某个数字开始

txt复制
5. 从五开始
6. 六

任务列表

txt复制
- [ ] 未完成
- [x] 已完成
- [ ] 也可以嵌套
  - [x] 子任务

[x] 大小写都行；导出为纯 Markdown 时它是普通文本，不是复选框。

引用

txt复制
> 一级引用
>> 嵌套引用
> 
> 引用里也可以有 **强调** 和列表：
> - 第一点
> - 第二点
  • 空引用写成 > 单独一行，用来分段。
  • 引用块内可以放标题、代码、表格。

分割线

txt复制
---
***
___

三种写法等价。为避免和 Setext 标题冲突，--- 前面必须空一行。

链接

txt复制
[文字](https://example.com)
[带标题](https://example.com "鼠标悬停显示")
<https://example.com>            自动链接
https://example.com              裸链接（GFM 自动识别）
[空链接](#)
[锚点](#某个标题)
[参考式][id]
 
[id]: https://example.com "可选标题"
  • 标题里有空格或括号时，URL 用 <尖括号> 包起来。
  • 锚点由标题自动生成：小写、空格转 -、去掉标点。

图片

txt复制
![替代文字](图片地址)
 
[![图片可点击](图片.png)](https://example.com "跳转链接")
  • 图片语法就是链接前面多一个 !。
  • 图片同样支持参考式写法。

代码

行内代码

txt复制
用 `console.log()` 输出。
如果内容本身有反引号，用两个反引号包起来：``a`b``

围栏代码块

txt复制
```js
const a = 1
console.log(a)
```

不标注语言（纯文本）

txt复制
```
原样输出，不做高亮
```

代码块里再放代码

外层用 四个 反引号，内层用三个：

txt复制
js复制
code
代码复制
  • 围栏也可以用 ~~~。
  • 语言标识常见值：js ts py java c cpp go rust bash sql json yaml html css md diff txt

表格

txt复制
| 左对齐 | 居中 | 右对齐 |
| :----- | :--: | -----: |
| a      | b    | c      |
| 文字   | 很长 | 1      |
  • : 的位置决定对齐：左边冒号左对齐，两边都有冒号居中，右边冒号右对齐。
  • 没有表头行就不是表格。
  • 单元格里要写竖线 |，用 \| 转义。
  • 表格内可以放行内代码、链接、强调，但一般不能放列表和段落。

脚注

txt复制
这里有一句话，需要引用来源[^1]。
 
[^1]: 这是脚注的内容，可以写多行。

脚注会自动编号并跳到页面底部，属于扩展语法（CommonMark 之外）。

删除线、高亮、上下标

txt复制
~~删除线~~
==高亮==
x^2^            上标
H~2~O           下标

后三种是扩展语法，支持度不一；不确定时用 HTML：<sup>、<sub>。

数学公式

行内

txt复制
质能方程 $E = mc^2$ 写在行内。

块级

txt复制
$$
\int_{0}^{\infty} e^{-x^2}\,dx = \frac{\sqrt{\pi}}{2}
$$
  • 行内用单个 $，块级用前后各一行 $$。
  • 公式里的 _、* 不会触发斜体。
  • 需要渲染器开启 KaTeX / MathJax。

图表（Mermaid）

txt复制
```mermaid
graph LR
  A[开始] --> B{判断}
  B -->|是| C[执行]
  B -->|否| D[结束]
```

支持流程图、时序图、甘特图、类图等，取决于渲染器是否内置 Mermaid。

HTML 混写

txt复制
<br>                强制换行
<details>
<summary>点击展开</summary>
 
隐藏的内容，里面可以写 Markdown。
 
</details>
 
<kbd>Ctrl</kbd> + <kbd>C</kbd>
<sub>下标</sub> <sup>上标</sup>
  • 多数渲染器允许内嵌 HTML，但 Markdown 语法在 HTML 块内通常不再解析。
  • 出于安全，<script>、<style> 一般会被过滤。

转义字符

txt复制
\* 不是斜体
\# 不是标题
\[ 不是链接
\\ 表示反斜杠本身

可加反斜杠转义的符号：

txt复制
\ ` * _ { } [ ] ( ) # + - . ! | > ~ $ %

扩展语法（Obsidian / 本库风格）

txt复制
[[另一篇笔记]]             内部链接
[[笔记#标题]]              链接到某标题
![[另一篇笔记]]            嵌入整篇
![[图片.png]]              嵌入图片
#标签  #多级/标签
%%这是注释，不显示%%
  • 具体语法随库的实现而变，不确定时以库内帮助为准。

语法速查

想要 写法
标题 # 标题
粗体 **文字**
斜体 *文字*
删除线 ~~文字~~
行内代码 `代码`
代码块 三个反引号包住
链接 [文字](url)
图片 ![文字](url)
引用 > 文字
无序列表 - 项目
有序列表 1. 项目
任务 - [ ] 待办
表格 | a | b | + | --- | --- |
分割线 ---
脚注 [^1] + [^1]: 内容
公式 $公式$
转义 \*

书写习惯建议

  1. 标题层级不要跳级：# → ## → ###。
  2. 段落之间统一空一行，别靠两个空格换行来排版。
  3. 代码块一律标注语言，高亮和可读性都会好很多。
  4. 列表符号在同一篇里保持一致。
  5. 中文与英文、数字之间留空格，阅读更舒服。