基础 Markdown 语法
Obsidian 笔记常用的 Markdown 基础排版语法。
Obsidian 在标准 Markdown 之上还有双链、嵌入、标注等扩展，见 Obsidian 扩展 Markdown 与 嵌入与标注。
Obsidian 笔记本质是 .md 纯文本。下面按使用频率列出常用语法；在阅读视图或实时预览中即可看到渲染效果。
段落与换行
段落之间用空行分隔，每个文本块会被渲染为独立段落。
这是第一段。
这是第二段。段内换行
默认情况下，只按一次 Enter 在编辑区会换行，但渲染时仍属于同一段落（标准 Markdown 软换行）。
若要在同一段落内强制换行，可以：
- 在行末加 两个空格 再按
Enter，或 - 使用
Shift + Enter插入换行。
若开启 设置 → 编辑器 → Strict line breaks（严格换行），行为会更贴近标准 Markdown 规范：单次回车可能合并为一行，双次回车才形成新段落。
标题
行首加 1～6 个 # 表示标题级别，# 数量越多级别越低。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题标题会出现在 Obsidian 的大纲面板中，便于长文导航。
文本样式
| 样式 | 写法 | 示例输出 |
|---|---|---|
| 加粗 | **文字** 或 __文字__ | 加粗 |
| 斜体 | *文字* 或 _文字_ | 斜体 |
~~文字~~ | ||
| ==高亮== | ==文字== | ==高亮==（Obsidian 扩展） |
| 加粗斜体 | ***文字*** | 加粗斜体 |
| 加粗内嵌斜体 | **加粗 _嵌套斜体_ 文字** | 加粗 嵌套斜体 文字 |
若希望符号原样显示、不被解析，可在符号前加反斜杠 \：
\*\*这行不会变成加粗\*\*内部链接（双链）
Obsidian 支持两种链到仓库内笔记的方式：
Wikilink（推荐）：
[[牛顿三定律]]
[[牛顿三定律|显示别名]]
[[牛顿三定律#某标题]]标准 Markdown 链接：
[牛顿三定律](牛顿三定律.md)
[某标题](牛顿三定律.md#某标题)文件名含空格时，URL 中空格需写成 %20。
外部链接
[帮助文档](https://example.com)链接到其他 Vault 中的文件时，可使用 Obsidian URI：
[某笔记](obsidian://open?vault=MainVault&file=Note.md)URL 含空格时用 %20 转义，或用尖括号包裹 URL：
[我的笔记](<obsidian://open?vault=MainVault&file=My%20Note.md>)外部图片
在链接前加 ! 即可插入图片：
指定显示尺寸（宽 × 高，或仅宽度按比例缩放）：
仓库内部图片也可嵌入，写法见进阶文档中的文件嵌入。配合 图床 时，此处 URL 换成图床地址即可减轻仓库体积。
引用
行首加 >：
> 这是一段引用。
> 可以多行。
> — 署名在引用第一行加 [!info] 等可转为 Obsidian 标注（Callout），详见 嵌入与标注。
列表
无序列表
- 第一项
- 第二项
- 第三项*、+ 与 - 效果相同。
有序列表
1. 第一项
2. 第二项
3. 第三项也支持 1)、2) 形式。列表项内换行可用 Shift+Enter，不打断编号。
任务列表
- [x] 已完成
- [ ] 未完成阅读视图中可直接点击复选框切换状态。括号内也可用 ?、- 等自定义完成标记。
嵌套列表
子项前缩进（通常一个 Tab）：
1. 一级
1. 二级有序
2. 一级
- 二级无序
- [ ] 父任务
- [ ] 子任务选中多项后可用 Tab / Shift+Tab 批量调整层级。
分隔线
单独一行写三个及以上 *、- 或 _（中间可有空格）：
***
---
___代码
行内代码
用单个反引号包裹：
使用 `npm install` 安装依赖。反引号本身需用双反引号包裹：`` 含 反引号 `` `
代码块
用三个及以上反引号或波浪线围成块：
```js
function hello() {
console.log("Hello");
}
```在 opening fence 后写语言名可启用语法高亮（Obsidian 使用 Prism）。也支持用 4 个空格 或 Tab 缩进形成代码块。
嵌套代码块时，外层 fence 的反引号数量必须多于内层。
脚注
正文中的说明[^1]。
[^1]: 脚注内容写在文末。
[^note]: 命名脚注在渲染时仍显示为数字。多行脚注内容，每行开头加两个空格。
行内脚注（仅阅读视图有效）：
这是行内脚注^[脚注内容在这里。]。注释（编辑时可见）
用 %% 包裹的内容只在编辑视图显示，导出/阅读时不出现：
%% 这是行内注释 %%
%%
这是块注释，
可以跨多行。
%%转义特殊字符
需要在正文中原样显示 *、_、#、`、| 等时，前面加 \：
\*不会变斜体\*
\# 不会变标题
1\. 不会被当成列表下一步
- 进阶排版语法：表格、Mermaid 图、数学公式
- 内部链接详解
- Obsidian 扩展 Markdown
最后更新时间: 2026-06-18 02:53:47