obsidian(md笔记管理)使用实践
<p>省流版本:obsidian更加强调笔记管理,typora更加注意笔记编辑和查看体验。obsidian需要一番折腾typora开箱即好用,但最重要的还是你要开始写,那怕只写一个字,一段话。<br>ps.可能有人会说vscode也能编程和管理md,但是obsidian有索引,全局搜索更加快。</p>
<p>我的obsidian版本为v1.10.6</p>
<h2 id="原理篇">原理篇</h2>
<p>在Obsidian要先创建一个“库”(Vault)作为所有相关笔记的容器,Typora更侧重于编辑单个文件,而Obsidian管理的是一个相互关联的知识体系。</p>
<p>obsidian保存数据的原理:How Obsidian stores data - Obsidian Help</p>
<h2 id="obsidian与markdown语法差异踩坑">obsidian与markdown语法差异踩坑</h2>
<p>obsidian与markdown的标准语法有一些差异,下面是我的踩坑总结</p>
<table>
<thead>
<tr>
<th>差异领域</th>
<th>Obsidian 特有现象/语法</th>
<th>标准 Markdown / Typora 常见情况</th>
<th>关键影响与建议</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>图片与链接</strong></td>
<td>默认使用 Wiki 链接:<code>![[图片.png]]</code></td>
<td>标准语法:<code></code></td>
<td><strong>兼容性陷阱</strong>:Wiki 链接其他软件不识别。<br><br>需修改设置。</td>
</tr>
<tr>
<td><strong>路径与空格</strong></td>
<td>路径中含空格或特殊字符可能导致链接失效</td>
<td>通常能自动处理空格</td>
<td><strong>链接稳定性风险</strong>:建议路径用 <code><></code>包裹或避免空格。</td>
</tr>
<tr>
<td><strong>编辑体验</strong></td>
<td>实时预览需切换模式,或分栏显示</td>
<td>真正的<strong>所见即所得</strong>,输入即渲染</td>
<td><strong>体验差异</strong>:Obsidian 的“实时预览”仍是代码视图,可通过插件改善。</td>
</tr>
<tr>
<td><strong>换行处理</strong></td>
<td>严格模式下,单回车不换行,需两空格+回车或双回车</td>
<td>回车通常直接产生换行</td>
<td><strong>排版困惑</strong>:注意编辑器中的“严格换行”设置。</td>
</tr>
<tr>
<td><strong>独特语法</strong></td>
<td>注释:<code>%%注释内容%%</code></td>
<td>使用 <code><!-- 注释内容 --></code></td>
<td><strong>通用性问题</strong>:Obsidian 特有注释在其他地方不显示。</td>
</tr>
<tr>
<td></td>
<td>图片调整:<code>![[图片.png\100]]</code></td>
<td>通常依赖 HTML 或 CSS</td>
<td><strong>功能便捷但专属</strong>:此语法为 Obsidian 特有。</td>
</tr>
<tr>
<td></td>
<td>高亮:<code>==高亮内容==</code></td>
<td>非标准语法,Typora 需开启支持</td>
<td>非标准语法,依赖特定解析器。</td>
</tr>
<tr>
<td><strong>数据管理</strong></td>
<td><strong>本地优先</strong>,数据存储在本地文件夹</td>
<td>许多工具为云同步优先</td>
<td><strong>思维转变</strong>:需自行安排同步备份策略。</td>
</tr>
</tbody>
</table>
<h2 id="必备设置">必备设置</h2>
<p><strong>图片保存到相对路径下:</strong><br>
打开设置 - 文件与链接 -附件默认存放路径:选当前文件所在文件夹下指定的子文件夹,子文件夹名称:images</p>
<p><strong>搜索结果在新标签页打开:</strong><br>
按住Ctrl+鼠标点击结果</p>
<p><strong>打开单个文件</strong><br>
先安装better file link插件,然后按住Ctrl再拖文件到obsidian(实测在1.9x版本按住可直接拖都无反应)</p>
<p><strong>中文文件名与路径</strong>:<br>
在涉及链接和附件路径时,不要使用中文字符或空格,以防止在某些特定场景下(如个别插件或其他Markdown编辑器)出现解析问题,可以用连字符(<code>-</code>)或下划线(<code>_</code>)代替空格。</p>
<h2 id="大坑图片语法格式">大坑:图片语法格式</h2>
<pre>标准markdown格式:

obsidian格式:
![]
</pre>
<p><code>![]</code>是 Obsidian 特有的“Wiki 链接”语法并不是标准的markdown语法,此格式在 Obsidian 内能正常显示图片,但在其他 Markdown 编辑器(如 Typora、VS Code 等)中就无法正确显示图片。<br>
我们要让他实现最佳的兼容性,并且保证obsidian的wiki正常工作。<br>
处理方法:</p>
<ol>
<li>进入 Obsidian 的 设置 (Settings)</li>
<li>在侧边栏找到 <strong>文件与链接</strong> (Files & Links) 选项</li>
<li>关闭<strong>使用 Wiki 链接</strong> (Use Wikilinks) 这个选项</li>
<li>对于1.9版本,还要设置 【内部链接类型】- 基于当前笔记的相对路径</li>
<li>设置完之后,粘贴一张图片,查看语法是否符合markdown标准</li>
</ol>
<h2 id="常用快捷键">常用快捷键</h2>
<table>
<thead>
<tr>
<th>快捷键</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>Ctrl+Shift+F</td>
<td>全局搜索文件</td>
</tr>
<tr>
<td>Ctrl+,</td>
<td>打开设置</td>
</tr>
<tr>
<td>Ctrl + Shift + T</td>
<td>打开刚刚关闭的</td>
</tr>
<tr>
<td>Ctrl + -</td>
<td>返回刚刚打开文档</td>
</tr>
<tr>
<td>Ctrl + 鼠标点击</td>
<td>搜索结果以新标签页打开</td>
</tr>
<tr>
<td>Ctrl+E</td>
<td>编辑和阅读视图切换</td>
</tr>
</tbody>
</table>
<h2 id="与typora持平的插件">与typora持平的插件</h2>
<p>ob安装后在默认设置下欠缺一些功能,需要安装插件才能有和typora相同的使用体验</p>
<table>
<thead>
<tr>
<th style="text-align: left">插件名</th>
<th style="text-align: left">功能描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">Brat</td>
<td style="text-align: left">第三方插件市场</td>
</tr>
<tr>
<td style="text-align: left">QuickAdd</td>
<td style="text-align: left">在文件夹中新建文件</td>
</tr>
<tr>
<td style="text-align: left">fast image cleaner</td>
<td style="text-align: left">在md中删除图片</td>
</tr>
<tr>
<td style="text-align: left">recent files</td>
<td style="text-align: left">显示最近打开的文件</td>
</tr>
<tr>
<td style="text-align: left">custom attachment location</td>
<td style="text-align: left">自定义md插入图片格式</td>
</tr>
<tr>
<td style="text-align: left">table generator</td>
<td style="text-align: left">类typora的插入表格</td>
</tr>
<tr>
<td style="text-align: left"></td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">以下是加强体验的扩展</td>
<td style="text-align: left"></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left">插件名</th>
<th style="text-align: left">功能描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">Lazy Plugin Loader</td>
<td style="text-align: left">延迟加载插件,加快启动速度</td>
</tr>
<tr>
<td style="text-align: left">Hide Folders</td>
<td style="text-align: left">隐藏文件夹</td>
</tr>
<tr>
<td style="text-align: left"></td>
<td style="text-align: left"></td>
</tr>
</tbody>
</table>
<p>以下第三方插件,在官方市场找不到,需要在Brat中安装</p>
<table>
<thead>
<tr>
<th style="text-align: left">插件名</th>
<th style="text-align: left">功能描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">fast image cleaner</td>
<td style="text-align: left">在md中删除图片</td>
</tr>
<tr>
<td style="text-align: left">attachment flow</td>
<td style="text-align: left">查看图片,删除图片(在1.9下无法删除图片)</td>
</tr>
</tbody>
</table><br><br>
来源:https://www.cnblogs.com/zhaoqingqing/p/19349748
頁:
[1]