Obsidian 入门教程

❓ Obsidian 支持 .txt 文件吗？

简单回答是：支持，但你不应该用它。

详细解释：

1. “支持”的方面： Obsidian 默认会在文件列表中隐藏 .txt 文件。但是，你可以在 设置 (Settings) -> 文件与链接 (Files & Links) -> “Detect all file extensions” (检测所有文件扩展名) 中打开开关。打开后，你的 .txt 文件就会在文件库中可见了。
2. “不该用”的方面： Obsidian 是一款为 Markdown (.md) 而生的工具。它所有的核心功能——包括双向链接 [[...]]、标签 #...、嵌入 ![[...]]、代码高亮、插件等——都只在 .md 文件中才能正常工作。
3. 给你的建议： 你应该把所有的 .txt 笔记全部重命名为 .md。因为 Markdown 本质上就是“增强版的纯文本”，你不会损失任何东西，反而能获得 Obsidian 的全部能力。

---

👨‍💻 Obsidian 入门教程 (开发者版)

欢迎来到 Obsidian。你作为一名10年PHP开发者，请不要把它当作一个“笔记软件”（像有道云或印象笔记），你应该把它看作一个 “你本地知识库的IDE”。

它的哲学完全符合开发者的思维：

• 数据是你自己的： 它不是SaaS，它不存你的数据。你的笔记就是你硬盘上的一个文件夹 (MyDocs)。
• 纯文本优先： 核心文件是 .md，你可以用 VS Code、Typora 甚至 Vim 随时打开它。
• Git 友好： 你的整个笔记库可以用 Git 来做版本控制。

阶段一：理解核心概念 (The “Aha!” Moment)

1. “仓库” (Vault) 是什么？

• 它就是一个本地文件夹，仅此而已。
• 当你启动 Obsidian 时，它会问你“打开一个文件夹作为仓库 (Open folder as vault)”。
• 建议： 在你的 D:\ 或 Documents 下新建一个文件夹，比如 MyKnowledgeBase，然后用 Obsidian 打开它。这个文件夹就是你的“仓库”。你可以随时 cd 进去，git init 它。

2. 核心界面 (3栏布局)

• 左侧栏： 文件浏览器（你的文件夹目录）、搜索。
• 中间栏： 编辑器（你写 .md 文件的地方）。
• 右侧栏： “反向链接” (Backlinks) 和 “标签” (Tags)。（这个稍后讲）

3. 写作 (就是 Markdown)

• 你已经会了。在仓库里新建一个笔记，比如 PHP学习.md。
• 你熟悉的 ## 标题、* 列表、<code>php ... </code> 代码块… 都完美支持。

阶段二：掌握“链接” (Obsidian 的灵魂)

这是 Obsidian 与 Word / .txt 最大的不同。Obsidian 的核心不是“文档”，是“链接”。

1. 双向链接 (Wiki Links)

• 语法： [[文件名]]

• 实战：

  1. 你有一个笔记叫 Swoole.md。
  2. 你正在写 PHP高并发.md，当你写到 “…要实现高并发，我们可以使用 [[Swoole]] 扩展…”
  3. Obsidian 会自动识别 [[Swoole]]，并将其变成一个链接。

• “双向”体现在哪里？

  • 你从 PHP高并发.md 点击可以跳到 Swoole.md (这是“正向”)。
  • 你打开 Swoole.md，在右侧的“反向链接”面板，你会看到 “PHP高并发.md” 提到了它 (这是“反向”)。

• 这对开发者意味着什么？ 你可以建立一个知识网络。你的“项目A文档”可以链接到“MySQL优化笔记”，而“MySQL优化笔记”的反向链接会显示出所有提到它的“项目文档”。

2. 嵌入 (Embedding)

• 语法： ![[文件名]] (就是链接前面加个 !)
• 实战：
  • 你有一个笔记 可复用的Nginx配置.md，里面只有一段 nginx ... 代码。
  • 在你写的 项目A部署.md 和 项目B部署.md 里，你都可以用 ![[可复用的Nginx配置.md]] 来把那段代码直接嵌入到当前文档中。
  • 这对开发者意味着什么？ “代码复用”！你修改一次源文件，所有嵌入了它的地方都会自动更新。

阶段三：组织你的知识 (文件夹 vs 标签)

1. 文件夹 (Folders)

• 和你管理 PHP 项目一样，你可以用文件夹来做“物理”隔离。
• 例如：Projects/、TechNotes/PHP/、TechNotes/Go/、Daily/。
• 优点： 结构清晰。
• 缺点： Swoole.md 应该放在 PHP 还是 Go (它也有Go的协程思想) 还是 Network 文件夹下？—— 这就是“文件夹”的局限性。

2. 标签 (Tags)

• 语法： #标签名 (比如 #php, #network, #todo)

• 实战： 你把 Swoole.md 放在 TechNotes/PHP/ 文件夹下，但在笔记的任意位置，你可以加上 #network, #concurrency (并发), #php。

• 优点： “多维分类”。在左侧栏的“标签面板”，你点击 #network，所有带这个标签的笔记都会被筛选出来。

• 给开发者的建议：

  • 用“文件夹”存放“明确的项目” (Project A, Project B)。
  • 用“标签”和“双向链接”管理“零碎的知识” (Tech Notes)。

阶段四：开发者“必装”插件 (解锁 200% 的能力)

Obsidian 的“核心”很小，但它的“插件”是 VS Code 级别的。
路径： 设置 (Settings) -> 第三方插件 (Community Plugins) -> 关闭“安全模式” -> 浏览。

1. Obsidian Git (必装)

• 功能： 你的“终极同步方案”。
• 配置： 让它定时（比如每10分钟）自动 git add ., git commit -m "auto update", git push 到你指定的 私有 Git 仓库（Gitee, GitHub, GitLab…）。
• 结果： 免费、安全、带版本控制（可以找回历史）的云同步。

2. Excalidraw (推荐)

• 功能： 在 Obsidian 里直接画“架构图”。
• 实战： 你在写 项目A架构.md，可以直接插入一个 xxx.excalidraw 文件，在里面画出你的 Nginx -> PHP-FPM -> MySQL 的请求流程图。

3. Dataview (进阶)

• 功能： “知识库的 SQL”。它让你用“查询语句”来动态生成笔记。
• 实战： 你可以在一个笔记里写：

  LIST
  FROM #php AND #todo
  

  它会自动显示出所有“同时包含 #php 和 #todo 标签”的笔记列表。
• 这对开发者意味着什么？ 自动化！你可以做自己的“项目看板”、“Bug追踪列表”。

---

总结：给你的起步建议

1. 忘记 .txt，全面拥抱 .md。
2. 在你本地创建一个 ObsidianVault 文件夹，用 Obsidian 打开它。
3. git init 这个文件夹，并连接到一个私有 Gitee/GitHub 仓库。
4. 安装 Obsidian Git 插件，实现自动备份。
5. 开始写笔记。不要过度设计文件夹结构，放心地写。
6. 优先使用 [[双向链接]]，而不是文件夹，来组织你的知识点。