Star Nebula Knowledge

切换主题

2026-10-22 08:181028 字Markdown标记语言笔记方法

速查表：Markdown 语法速查表（访问于 2026-10-22） 官方文档：Markdown 基本语法（访问于 2026-10-22）

本文以标准 Markdown（CommonMark + GFM）为主；涉及 Obsidian 专有写法时会单独标注。

速查表 ​

需求写法
标题# 一级标题 … ###### 六级标题
粗体**粗体**
斜体*斜体*
粗斜体***粗斜体***
删除线~~删除线~~
引用> 引用内容
无序列表- 列表项
有序列表1. 列表项
行内代码用反引号包裹
链接[显示文字](https://example.com)
图片![替代文字](图片路径)
分隔线---
任务列表- [ ] 待办

1. 标题 ​

在行首使用 1～6 个 #，# 与标题文字之间必须有空格，数量对应标题级别：

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

也可以用下划线形式标记一级、二级标题：

markdown
一级标题
========

二级标题
--------

建议按 1→2→3 的顺序组织文档，不要为了字号跳级。

2. 段落与换行 ​

段落之间用空行分隔。不要用空格或制表符缩进段落。

单个换行通常会被渲染成空格；需要强制换行时，在行尾加两个空格再回车，或使用 HTML 的 <br>：

markdown
第一行  
第二行（上一行末尾有两个空格）

这是另一个段落。

3. 强调 ​

markdown
**粗体** 或 __粗体__
*斜体* 或 _斜体_
***粗斜体*** 或 ___粗斜体___
~~删除线~~
A*cat*meow

注意事项：

  • 单词中间的强调用 *，用 _ 可能不生效。
  • 粗体、斜体符号与文字之间不要留空格。
  • 删除线属于 GFM 扩展，Obsidian、GitHub、VitePress 均支持。

4. 引用 ​

在段落前加 >。多段引用用空 > 行分隔，嵌套引用叠加 >：

markdown
> 单个引用块

> 第一段
>
> 第二段

> 第一段
>
> > 嵌套引用

引用块内可以放列表、代码等 Markdown 元素。引用上下建议留空行，避免和相邻段落粘连。

5. 列表 ​

5.1 无序列表 ​

使用 -、* 或 + 开头。同一篇笔记里最好统一用一种符号：

markdown
- 第一项
- 第二项
  - 嵌套项

5.2 有序列表 ​

使用数字加英文句点。数字不必连续，渲染时会自动编号，但建议按顺序书写便于阅读：

markdown
1. 第一项
2. 第二项
   1. 嵌套项

5.3 列表中的多段内容 ​

列表项内要放多个段落时，第二段需要缩进，与列表项正文对齐：

markdown
1. 第一段

   第二段，与列表项正文对齐缩进。

2. 下一项

5.4 列表中的代码块 ​

代码块需要比列表内容再缩进 4 个空格（或用围栏代码块）：

markdown
1. 打开文件。
2. 找到下面的代码块：

       <html>
         <head><title>Test</title></head>
       </html>

3. 修改标题。

5.5 任务列表 ​

GFM 与 Obsidian 支持任务列表：

markdown
- [ ] 未完成
- [x] 已完成

6. 代码 ​

行内代码用反引号包裹：

markdown
使用 `print()` 输出内容。

如果代码本身包含反引号，用双反引号包裹：

markdown
``包含 ` 反引号的代码``

多行代码用三个反引号围起来，并在开头标注语言以获得高亮：

markdown
```python
def hello():
    print("Hello")
```

也可以用缩进 4 个空格表示代码块：

markdown
    def hello():
        print("Hello")

7. 分隔线 ​

在单独一行使用三个或更多的 ---、***、___，行内不能有其他内容：

markdown
---

***

___

分隔线上下留空行。注意：--- 紧跟在文字下方时会被解析为二级标题的下划线，而不是分隔线。

8. 链接 ​

基本写法：

markdown
[Markdown 语法](https://markdown.com.cn "Markdown 教程")

自动链接：

markdown
<https://markdown.com.cn>
<fake@example.com>

带格式的链接：

markdown
**[EFF](https://eff.org)**

引用式链接：

markdown
[引用式链接][1]

[1]: https://example.com "链接标题"

其他规则：

  • 链接地址中的空格要写成 %20。
  • 站内跳转可用相对路径，如 [另一篇笔记](./另一篇笔记.md)。
  • 跳转到当前页面的标题：[代码](#6-代码)。锚点由标题文字生成，中文标点通常会被去掉。
  • 发布到站点时，正文内部链接优先用标准 Markdown 链接，不要用指向非发布目录的 wikilink。

9. 图片 ​

标准 Markdown 图片语法：

markdown
![替代文字](images/example.png "图片标题")

图片也可以包在链接里，点击后跳转：

markdown
[![替代文字](images/example.png)](https://example.com)

Obsidian 专有写法（不是标准 Markdown）：

markdown
![[example.png]]
![[example.png|替代文字]]

说明：

  • ![[...]] 只在 Obsidian 或本知识库的 VitePress 插件中生效，其他 Markdown 工具请用 ![alt](path)。
  • 本地图片要放在发布面内的附件目录，否则站点构建时会显示「图片缺失」。
  • 图片路径建议使用相对路径，避免换机器后失效。

10. 转义字符 ​

在特殊字符前加反斜杠 \，让它按字面显示：

markdown
\*不是斜体\*
\_不是斜体\_
\# 不是标题
\[不是链接\]
\\ 表示一个反斜杠
\` 表示一个反引号

HTML 中的 < 和 & 需要写成实体：

实体显示
&lt;<
&amp;&
&gt;>

代码块和行内代码中的字符不需要转义。

11. 内嵌 HTML ​

Markdown 可以直接写 HTML。行内标签：

markdown
这是 <em>斜体</em>，按 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制。

块级标签：

markdown
<table>
  <tr>
    <td>Foo</td>
  </tr>
</table>

块级 HTML 上下建议留空行。部分 Markdown 语法在原始 HTML 块内部不会被解析，需要写成对应的 HTML 标签。

12. 表格（GFM） ​

markdown
| 左对齐 | 居中 | 右对齐 |
| :--- | :---: | ---: |
| A | B | C |

规则：

  • 表头下面必须有分隔行，用 --- 表示，冒号控制对齐。
  • 单元格里的竖线要转义成 \|。
  • 表格属于 GFM 扩展，Obsidian、GitHub、VitePress 均支持。

13. 脚注（GFM / Obsidian） ​

markdown
正文中的脚注[^1]。

[^1]: 脚注的具体内容。

14. 常见易错点 ​

  • #、>、- 等标记与正文之间要有空格。
  • 段落之间要空行；只敲一次回车通常不会换行。
  • 列表嵌套要缩进，建议统一 4 个空格。
  • --- 上下留空行，否则可能变成标题下划线。
  • 行内代码用反引号包裹；内容含反引号时改用双反引号。
  • 标准图片语法是 ![alt](path)；![[...]] 是 Obsidian 专有写法。
  • 发布笔记里避免指向非发布目录的 wikilink，站点上会变成死链。

参考 ​

每一篇文章，都是时间的标本