省流版本：obsidian更加强调笔记管理，typora更加注意笔记编辑和查看体验。obsidian需要一番折腾typora开箱即好用，但最重要的还是你要开始写，那怕只写一个字，一段话。
ps.可能有人会说vscode也能编程和管理md，但是obsidian有索引，全局搜索更加快。

我的obsidian版本为v1.10.6

原理篇

在Obsidian要先创建一个“库”（Vault）作为所有相关笔记的容器，Typora更侧重于编辑单个文件，而Obsidian管理的是一个相互关联的知识体系。

obsidian保存数据的原理：How Obsidian stores data - Obsidian Help

obsidian与markdown语法差异踩坑

obsidian与markdown的标准语法有一些差异，下面是我的踩坑总结

​​图片与链接​​ 默认使用 Wiki 链接：![[图片.png]] 标准语法：![](图片.png) ​​兼容性陷阱​​：Wiki 链接其他软件不识别。

需修改设置。

​​路径与空格​​ 路径中含空格或特殊字符可能导致链接失效 通常能自动处理空格 ​​链接稳定性风险​​：建议路径用 <>包裹或避免空格。 ​​编辑体验​​ 实时预览需切换模式，或分栏显示 真正的​​所见即所得​​，输入即渲染 ​​体验差异​​：Obsidian 的“实时预览”仍是代码视图，可通过插件改善。 ​​换行处理​​ 严格模式下，单回车不换行，需两空格+回车或双回车 回车通常直接产生换行 ​​排版困惑​​：注意编辑器中的“严格换行”设置。 ​​独特语法​​ 注释：%%注释内容%% 使用 <!-- 注释内容 --> ​​通用性问题​​：Obsidian 特有注释在其他地方不显示。 图片调整：![[图片.png\100]] 通常依赖 HTML 或 CSS ​​功能便捷但专属​​：此语法为 Obsidian 特有。 高亮：==高亮内容== 非标准语法，Typora 需开启支持 非标准语法，依赖特定解析器。 ​​数据管理​​ ​​本地优先​​，数据存储在本地文件夹 许多工具为云同步优先 ​​思维转变​​：需自行安排同步备份策略。

差异领域	Obsidian 特有现象/语法	标准 Markdown / Typora 常见情况	关键影响与建议

必备设置

图片保存到相对路径下：
打开设置 - 文件与链接 - 附件默认存放路径：选当前文件所在文件夹下指定的子文件夹，子文件夹名称：images

搜索结果在新标签页打开：
按住Ctrl+鼠标点击结果

打开单个文件
先安装better file link插件，然后按住Ctrl再拖文件到obsidian(实测在1.9x版本按住可直接拖都无反应)

中文文件名与路径​​：
在涉及链接和附件路径时，不要使用中文字符或空格，以防止在某些特定场景下（如个别插件或其他Markdown编辑器）出现解析问题，可以用连字符（-）或下划线（_）代替空格。

大坑：图片语法格式

标准markdown格式：
![图片说明](images/xx.png)
obsidian格式：
![[file-20251031165837921.png]]

![[xx.png]]是 Obsidian 特有的“Wiki 链接”语法并不是标准的markdown语法，此格式在 Obsidian 内能正常显示图片，但在其他 Markdown 编辑器（如 Typora、VS Code 等）中就无法正确显示图片。
我们要让他实现最佳的兼容性，并且保证obsidian的wiki正常工作。
处理方法：

1. 进入 Obsidian 的 ​​设置​​ (Settings)
2. 在侧边栏找到 ​​文件与链接​​ (Files & Links) 选项
3. 关闭 ​​使用 Wiki 链接​​ (Use Wikilinks) 这个选项
4. 对于1.9版本，还要设置 【内部链接类型】- 基于当前笔记的相对路径
5. 设置完之后，粘贴一张图片，查看语法是否符合markdown标准

常用快捷键

Ctrl+Shift+F 全局搜索文件 Ctrl+, 打开设置 Ctrl + Shift + T 打开刚刚关闭的 Ctrl + - 返回刚刚打开文档 Ctrl + 鼠标点击 搜索结果以新标签页打开 Ctrl+E 编辑和阅读视图切换

快捷键	说明

与typora持平的插件

ob安装后在默认设置下欠缺一些功能，需要安装插件才能有和typora相同的使用体验

Brat 第三方插件市场 QuickAdd 在文件夹中新建文件 fast image cleaner 在md中删除图片 recent files 显示最近打开的文件 custom attachment location 自定义md插入图片格式 table generator 类typora的插入表格 以下是加强体验的扩展

插件名	功能描述

Lazy Plugin Loader 延迟加载插件，加快启动速度 Hide Folders 隐藏文件夹

插件名	功能描述

以下第三方插件，在官方市场找不到，需要在Brat中安装

fast image cleaner 在md中删除图片 attachment flow 查看图片，删除图片(在1.9下无法删除图片)

插件名	功能描述