外观
Obsidian：把笔记保存为本地 Markdown
Obsidian 适合希望长期保留笔记文件、通过链接组织知识，并愿意学习少量 Markdown 的用户。它把笔记保存在本地仓库中，仓库就是普通文件夹，主要笔记格式为 .md。本指南也采用 Markdown，便于编辑和发布。官网与下载、仓库与存储说明
建立第一个仓库
安装后选择创建仓库，使用容易理解的名称，例如「学习笔记」，并选择一个你能在 Finder 中找到的位置。先使用本地文件夹完成练习，再决定多设备同步方式，避免还没理解文件位置就同时配置多个同步服务。
创建「本周学习」笔记，输入标题、正文和一组清单。切换编辑与阅读视图，观察 # 标题、列表和普通段落怎样呈现。Markdown 依赖符号和换行表达结构，不需要为每段文字单独设置字体大小。
一个完整练习
- 新建「Mac 快捷键」笔记，写下三个真正用过的快捷键。
- 在「本周学习」里添加指向它的链接。普通仓库可用 Obsidian 双链；准备发布的网站内容可采用标准 Markdown 相对链接。
- 拖入一张没有个人信息的截图，查看附件实际存放位置。
- 使用搜索找到刚才的快捷键，再在 Finder 中找到对应
.md文件。 - 复制一份笔记和附件到独立位置，检查这份副本是否仍能读到文字与图片。
这个练习帮助你理解：Obsidian 界面、笔记文件、图片附件和仓库设置是不同层次的内容。移动笔记或附件后，应检查链接是否仍然正确。官方入门帮助
用文件夹、链接和标签各司其职
不必先设计庞大的目录体系。可以只建「收件箱」「主题笔记」「附件」三个文件夹：随手记录进收件箱，需要长期复用的解释进入主题笔记，图片集中保存到附件目录。在「设置 → 文件与链接」中指定新附件位置，拖入一张测试图片，再到 Finder 核对它实际保存在哪里。
给每个文件取容易搜索的名字，例如「怎样恢复误删的文件」，比只有日期的标题更容易找回。一个问题写清楚后，在有关联的另一篇笔记中链接它，而不是复制同一段内容到多处。点开该笔记的反向链接面板，可以看到哪些笔记正在引用它；面板不可见时，从命令面板查找显示反向链接的命令。反向链接说明
标签适合简短的类别或状态，例如 #待整理；链接适合需要解释、会持续积累内容的概念，例如「文件备份」。这是一种组织习惯，不是必须遵守的分类法。关键是下次需要信息时，能用搜索或相关链接找到它，而不是标签越多越好。
为本指南选择可发布的链接
Obsidian 同时支持自己的双链和标准 Markdown 链接。如果你的仓库也准备发布为 VitePress 网站，在「文件与链接」中关闭「使用 Wikilinks」，新链接格式选择基于当前文件的相对路径，启用内部链接自动更新。这样正文、附件在普通 Markdown 工具中也更容易复用。内部链接与互操作说明
本指南已经采用这套约定。发布文章放在 docs/，写作资料放在 writing/，不要把私人日记、账户资料或整份个人库移动到 docs/。公开仓库里的源文件也可能被直接读取，不能把「网站没有链接到它」当作保密措施。
用内置模板减少重复整理
启用核心插件「模板」，新建模板目录并在插件设置中指定它。写一份只包含「问题、尝试过程、结论、相关资料」四个小标题的模板，创建新笔记后从命令面板执行插入模板。模板是笔记的起点，不会强迫已有内容自动跟着改变。核心模板插件
在本指南仓库中，也可以将 writing/templates 设为模板目录，选用教程、软件或排障模板。插入后应立即修改标题、描述、标签和顺序值，而不是把模板提示语作为正文发布。先用核心功能形成习惯，再考虑复杂自动化。
插件、同步和备份
先使用内置编辑、搜索和链接功能。遇到明确需求后再安装社区插件，并阅读其说明和维护情况。官方明确指出，社区插件继承 Obsidian 的访问能力，可能访问电脑文件、联网或安装额外程序，并非每项操作都经过单独授权。处理敏感资料的仓库可以保持限制模式；测试新插件时先用样本仓库。插件安全说明
同步与备份解决不同问题：同步会把修改传到另一台设备，也可能把误删传过去；备份应保留可以回到过去的副本。为同一仓库选择一种主要同步方式，跨设备开始编辑前先等待同步完成；冲突时保留两份文件并比较，不直接覆盖不确定的版本。
备份要包含正文、附件与需要保留的 .obsidian 设置。选一篇无关紧要的笔记，尝试从备份恢复到另一个文件夹并检查图片、链接；不要直接覆盖正在使用的仓库。具体方法可接着阅读 Time Machine 与文件恢复。
收费与局限
Obsidian 应用本身免费使用，官方 Sync 与 Publish 是可选付费服务，支持开发的许可也是可选项。费用和服务范围以当前页面为准。官方定价
Obsidian 的自由度意味着你要自己决定文件整理方式，部分插件语法也不容易迁移。如果需求只是随手记录和扫描文档，系统备忘录可以先承担这部分工作；需要正式排版交付时，再使用文档编辑工具。
如果习惯先口述再整理，可把 Voicenotes 中核对过的文字转入主题笔记，或用 Typeless 向当前编辑框输入。它们的数据处理方式与本地 Markdown 文件不同，启用前分别检查云服务与隐私说明。
离开 Obsidian 时，笔记和附件仍是本地文件，可先用其他编辑器打开一份副本；Dataview 查询、某些插件图表和笔记嵌入则需要另外转换。能够读出文字，不等于所有插件视图会自动迁移。