本文介绍 Markdown 笔记格式的基础功能，涵盖核心语法和使用要点，适合初学者快速上手。

Markdown 简介

Markdown 是一种轻量级的标记语言，由 John Gruber 于 2004 年设计。它的核心理念是：让写作者专注于内容本身，而非排版样式——用简单的符号标记格式，源码可读，渲染美观。

优势

特性 说明
沉浸写作 纯键盘操作，无需鼠标切换工具栏，写作流不中断
高兼容性 支持所有主流平台（GitHub、Obsidian、Notion、飞书等），内容迁移零成本
结构清晰 标题层级、列表、引用一目了然，即使纯文本状态下也保持可读性
低学习成本 核心语法只需几分钟即可掌握
公式能力强 基于 LaTeX 语法，可渲染从简单到复杂的各类数学公式
生态完善 大量编辑器、插件、主题、转换工具支持

局限性

  • 样式统一但不够灵活：Markdown 的设计目标是”足够好用”而非”无所不能”。复杂的排版（如多栏布局、精确控制间距）需要借助 HTML 或 CSS 补充
  • 输出格式依赖渲染器：同一份 Markdown 在不同平台上的渲染效果可能存在细微差异
  • 可能被误认为 AI 生成：现在许多 AI 输出默认使用 Markdown 格式，尤其带 emoji 的 Markdown 文本在非 Markdown 环境中粘贴时显得突兀，容易让人误以为是 AI 直接复制的结果

块的概念

Markdown 引入了 块（Block） 的概念——这是它区别于传统文本编辑器的核心设计之一。

什么是块

在 Markdown 中，内容以”块”为单位组织。每两个块之间用空行隔开，每个块可以独立设定自己的类型：标题、段落、列表、引用、代码块、公式块等。

1
2
3
4
5
6
7
8
┌─────────────────────┐
│  这是一个段落块       │  ← 段落块
│  换行继续写仍是同一块  │
└─────────────────────┘
                       ← 空行（块的分隔线）
┌─────────────────────┐
│  这是另一个段落块     │  ← 新的段落块
└─────────────────────┘

在 Obsidian 这类”块编辑器”中，按回车会关闭当前块并创建一个新的块，新块可以切换为不同的类型。

块的特性

① 块是原子单位
一个块是一个不可分割的整体。块内的所有文本共享同一套格式设定——你不能让块内的前半部分是标题、后半部分是普通文本。每当你切换块类型，改动会作用于块内全部内容。
正确理解：

1
2
3
# 这一整行都是标题1
这里是普通段落
|←  整个块  →|

做不到的事情：

1
2
# 这部分是标题        ← 无法实现：同一块内混合不同格式
这部分又是普通文本

② 换行规则
在一个块内部，直接按回车（单个换行）会产生新段落，不是文本内部的软换行。要在块的内部换行需要Shift + Enter（回车）

1
2
3
4
这是第一行（同一块内）
这是第二行，仍然属于同一个块

这是新的段落块（中间有空行）

这个规则的好处是：即使 Markdown 源码没有自动换行，渲染后的阅读体验仍然清晰

③ 块类型的多样性
Markdown 常见的块类型包括：

块类型 语法标记 用途
段落 无特殊标记 普通文本
标题 # ~ ###### 层级标题
引用 > 引用内容
无序列表 - / * 列表项
有序列表 1. 编号列表
代码块 ``` 代码片段
公式块 $$ 数学公式

层级与结构编辑

所有 Markdown 符号都应在英文输入法下输入（半角符号），否则可能因字符编码不匹配导致格式无效。

标题

用 # 加空格表示标题层级。# 的个数对应标题的级别：

1
2
3
4
# 标题1（文章大标题）
## 标题2（章节标题）
### 标题3（子章节）
###### 标题6（最小标题，大小接近加粗正文）

注意区分标签与标题：
# 与文字之间有空格 = 标题
# 与文字之间无空格 = 标签（Tag），用于分类和检索

1
2
# 这是一个标题
#这是一个标签

引用

在文本的最左侧输入 > 将该段设为引用样式：

1
> 此处输入要引用的文本

引用块内部，文本样式（加粗、斜体等）仍然有效，但大部分块级格式（标题、列表）会失效：

此处为引用效果

标题功能失效

加粗 和 斜体 仍然有效

列表

无序列表：用 -、* 或 + 加空格开头

1
2
3
- 项目一
- 项目二
  - 子项目（缩进两个空格）

有序列表：用 1.、2. 加空格开头

1
2
3
1. 第一步
2. 第二步
   1. 子步骤（缩进两个空格）

代码块

用三个反引号包裹代码片段，可在开头指定语言以启用语法高亮：

1
2
3
```python
print("Hello, World!")
```

公式块

用两个美元符号 $$ 包裹 LaTeX 公式：

1
2
3
$$
E = mc^2
$$

注意：必须使用美元符号 $，而非人民币符号 ¥，否则无法识别。

文本样式

文本样式作用于块内的部分文字，与块级格式不同，它们可以混合使用。

快速参考

样式 语法 快捷键（Win / Mac） 效果
加粗 **文字** Ctrl+B / Cmd+B 加粗效果
斜体 *文字* Ctrl+I / Cmd+I 斜体效果
删除线 ~~文字~~ 无默认快捷键 删除线效果
==高亮== ==文字== 无默认快捷键 ==高亮效果==
代码 `文字` 无默认快捷键 行内代码样式
链接 [文字](url) Ctrl+K / Cmd+K 链接效果
图片 ![描述](url) 无默认快捷键 显示图片

详细说明

加粗与斜体是最常用的文本样式，支持嵌套使用：

1
2
3
**加粗文本**
*斜体文本*
***加粗加斜体***

删除线用两个波浪号包裹。注意区分中文全角 ～ 和英文半角 ~ ——只有后者有效：

1
~~这句被删掉了~~

高亮用两个等号包裹，在 Obsidian 等支持该语法的编辑器中呈现荧光笔效果：

1
==这是高亮文字==

行内代码用单个反引号包裹，适合在段落中标记函数名、文件名或短代码片段：

1
使用 `git commit` 命令提交更改。

链接的格式为 [显示文字](目标地址)，支持网页链接和笔记内部链接：

1
2
[GitHub](https://github.com)
[本地笔记](我的笔记.md)

图片的格式为 ![替代文字](图片路径)，替代文字在图片加载失败时显示：

1
![示例图片](image.png)

公式（行内）

如果需要在一段文字中嵌入公式（而非独立公式块），使用单个美元符号包裹：

1
爱因斯坦的质能公式 $E = mc^2$ 是物理学中最著名的方程之一。

效果：爱因斯坦的质能公式 $E = mc^2$ 是物理学中最著名的方程之一。

分割线

如果需要在文章输入分割线，则要输入---
效果:

总结：Markdown 语法速查

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
─────────────────────────────────────────────
  类型         语法                          
─────────────────────────────────────────────
  标题         # H1 → ###### H6
  加粗         **文字**
  斜体         *文字*
  删除线       ~~文字~~
  高亮         ==文字==
  行内代码     `代码`
  链接         [文字](url)
  图片         ![替代](路径)
  引用         > 文字
  无序列表     - 项目
  有序列表     1. 项目
  代码块       ```语言
  公式块       $$
  行内公式     $公式$
  标签         #标签（无空格）
  分隔线       ---
─────────────────────────────────────────────