Obsidian 特色语法

标准 Markdown 写到一半，你总会冒出几个”要是能……就好了”的念头：能不能高亮一句话？能不能藏一段备注？能不能加脚注？能不能打标签？Obsidian 在 CommonMark 之上加了一层小巧的扩展语法，正好回答这些问题。这一篇我们把这五件”小暗器”一次讲透。

高亮：==文字==

这是 ==重点中的重点==，请反复读三遍。

两个等号包裹的文字会带上荧光底色。它比加粗更轻盈，比引用更克制，适合做”画重点”。配合阅读时划线的高亮插件，是阅读笔记的灵魂。

注释：%%文字%%

这是可见的内容 %%这是只在编辑视图可见的备注%%。

%%
这一整段都是注释，
阅读视图里完全隐藏。
%%

注释只在你编辑时可见，发布或分享时自动消失。它适合写”写作意图""提醒未来的自己”等不希望出现在最终成品的文字。注意，行内注释前后不要留多余空格，否则可能被当成普通文本。

脚注：[^1] 与行内脚注

Obsidian 的本地优先理念[^1]深受技术派喜爱。

[^1]: 所有笔记都是本地纯文本文件，不依赖云端。

[^长记]: 命名脚注仍以数字呈现，但便于自己辨认。

引用符号 [^id] 在正文里出现，定义写在笔记任意位置（通常末尾），Obsidian 会自动编号并生成跳转。id 可以是数字或字母名称。

行内脚注更省事，把定义直接塞进正文：

这是一句带脚注的话。^[行内脚注的内容。]

注意：行内脚注目前只在阅读视图里渲染，实时预览里看不到效果，写正式文档时建议改用普通脚注。

标签：#tag 与嵌套标签

在正文任意位置写 # 加关键词即生成标签：

今天读完《卡片笔记法》 #阅读/方法论

嵌套用斜线分层：

#project/active
#project/active/obsidian-tutorial
#project/someday

嵌套标签在搜索、标签视图、关系图谱里都会按层级显示。tag:project 能匹配 #project 及其所有子标签，等于一键过滤整个项目线。

也可以在 Frontmatter 里集中声明：

---
tags:
  - 阅读/方法论
  - 2026/07
---

Frontmatter 里的标签和正文里的 # 标签是等价的，都会进入搜索与图谱。

标签命名规则

• 允许：字母、数字、下划线 _、短横线 -、斜线 /、Unicode 字符（含中文与 emoji）；
• 必须至少含一个非数字字符，#1984 不合法，#y1984 合法；
• 不能含空格，多词建议用 #camelCase、#snake_case 或 #kebab-case；
• 大小写不敏感，#Tag 与 #TAG 视为同一个，但标签视图会保留首次创建时的大小写。

小提示：标签与文件夹各有所长。文件夹管”存放”，标签管”主题”。一篇笔记只能在一个文件夹，但可以打无数个标签——后者更适合多维度的知识组织。

一张速查表

需求	语法
高亮	==文字==
注释	%%文字%%
脚注	正文[^1] + [^1]: 定义
行内脚注	正文^[定义]
标签	#tag 或 #nested/tag

---

这五个小语法看似不起眼，组合起来却能让笔记从”可读”走向”可检索、可演化”。下一篇，我们聊聊 Obsidian 给每篇笔记配备的”身份证”——属性。