Obsidian 入门教程

❓ Obsidian 支持 .txt 文件吗？

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

详细解释：

"支持"的方面： Obsidian 默认会在文件列表中隐藏 .txt 文件。但是，你可以在 设置 (Settings) -> 文件与链接 (Files & Links) -> "Detect all file extensions" (检测所有文件扩展名) 中打开开关。打开后，你的 .txt 文件就会在文件库中可见了。
"不该用"的方面： Obsidian 是一款为 Markdown (.md) 而生 的工具。它所有的核心功能------包括双向链接 [[...]]、标签 #...、嵌入 ![[...]]、代码高亮、插件等------都只在 .md 文件中才能正常工作。
给你的建议： 你应该把所有的 .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"。它让你用"查询语句"来动态生成笔记。
实战： 你可以在一个笔记里写：
dataview 复制代码
```
LIST
FROM #php AND #todo
```
它会自动显示出所有"同时包含 #php 和 #todo 标签"的笔记列表。
这对开发者意味着什么？ 自动化！你可以做自己的"项目看板"、"Bug追踪列表"。

总结：给你的起步建议

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

用obsidan 打开的仓库，只能显示 md 结尾的文件吗。其他 pdf word 等文件会不加载吗

这是一个非常关键的问题！你作为开发者，一定很关心"附件管理"和"文件兼容性"。

答案是：不，它绝对不只是显示 .md 文件！

Obsidian 对附件（Attachments）有非常好的支持，但它对不同类型的文件有三种不同的处理方式：

原生支持并编辑 (Core)
原生支持并查看 (Supported)
识别但无法查看 (Unsupported)

下面我来为你详细拆解，特别是你提到的 PDF 和 Word。

1. 核心文件：`.md` (Markdown)

会加载吗？ 是的，这是它的"母语"。
功能： 所有的核心功能（编辑、双向链接、标签、插件）都围绕它工作。

2. 支持的附件 (会加载 & 能查看)

这些文件类型是 Obsidian 的"二等公民"。你不能（或不方便）编辑它们，但 Obsidian 内置了查看器 ，你可以直接在 Obsidian 窗口内查看、链接和嵌入它们。

✅ PDF 文件 (.pdf)
- 会加载吗？ 会的，默认就会显示在文件列表里。
- 能查看吗？ 能。 Obsidian 有一个内置的 PDF 阅读器。
- 如何使用：
  1. 把 MyReport.pdf 拖入你的仓库文件夹。
  2. 它会显示在文件列表里。
  3. 点击它： 它会在一个新的 Obsidian 面板中打开，你可以像在浏览器里一样阅读它。
  4. 嵌入它： 在你的笔记中输入 ![[MyReport.pdf]]，这个 PDF 就会被直接嵌入到你的笔记页面中！
✅ 图片文件 (.png, .jpg, .gif, .svg 等)
- 会加载吗？ 是的，默认显示。
- 能查看吗？ 能，内置图片查看器。
- 如何使用： ![[MyImage.png]] 嵌入。
✅ 音频/视频文件 (.mp3, .mp4, .webm, .ogg 等)
- 会加载吗？ 是的，默认显示。
- 能查看吗？ 能，内置音视频播放器。
- 如何使用： ![[MyVideo.mp4]] 嵌入。

3. 不支持的附件 (需配置才加载，不能查看)

这部分就是你问的 Word 文件。

❌ Word 文件 (.doc, .docx), Excel (.xlsx), PPT (.pptx) 等
- 默认会加载吗？ 不会。 Obsidian 默认会忽略这些它不认识的"非附件"文件，你在文件列表里看不到它们。
- 如何让它加载？
  1. 设置 ⚙️ -> 文件与链接
  2. 打开"检测所有文件扩展名" (Detect all file extensions)。
  3. （你之前问过的设置）
- 打开后会怎样？
  1. 你的 .docx 文件现在会显示在文件列表里了。
  2. 你可以 [[MyWordFile.docx]] 这样链接到它。
- 点击它能查看吗？
  1. 不能。 Obsidian 没有内置的 Word / Excel 阅读器。
  2. 点击它会怎样？ Obsidian 会调用你操作系统的默认程序来打开它（比如，它会自动启动你电脑上的 Microsoft Word 或 WPS 来打开这个文件）。

总结：给你的建议

PDF： 放心用。 把 PDF 拖进 Obsidian，它会成为你知识库的一部分，可查看、可嵌入。
图片/音视频： 放心用。
Word/Excel/PPT： 不推荐（但可行）。
- 最佳实践： 转换格式。 把 Word 里的内容复制/粘贴 到一个新的 .md 文件中。这样内容才能被 Obsidian 搜索、链接和编辑。
- 次优实践： 如果你必须保留 Word 格式，可以先在 Word 里把它另存为 .pdf，然后再存入 Obsidian。这样它至少是"可读"的。
- 最后选择： 如果你非要存 .docx，请打开"检测所有文件扩展名"开关。并接受"Obsidian 只是你这个文件的'启动器'，而不是'查看器'"这个事实。