Obsidian · 兼容

换个 app 编 Obsidian 的 md 会损坏吗?
安全往返编辑

你的笔记都保存在本地 Obsidian vault 里,但有时不得不换个环境改文件:比如在不能随意装软件的办公电脑上、借来的笔记本上,或者临时只想改两句话,懒得启动整个库。你最顾虑的问题往往很具体:改完保存,顶部的 frontmatter 会不会丢?callout 会不会变成普通引用?双链标记会不会被破坏?

这篇文章梳理笔记在不同编辑器之间往返时的处理细节:哪些写法能保住,以及怎么编辑才能让笔记放回 Obsidian 时照常工作。

在浏览器中编辑 vault 内的 .md 文件,返回 Obsidian 正常打开 →

不了解 Obsidian 语法的编辑器容易破坏什么

普通 Markdown 编辑器并不清楚 Obsidian 的扩展写法。打开并保存文件时,可能会:删掉或重排开头的 YAML frontmatter;把 callout(> [!NOTE])退回成普通引用;弄乱 [[wikilink]] 双链和 ![[embed]] 嵌入;或者在 Dataview、Tasks 这类插件块上出岔子。你在换工具修改时犹豫不决,担心的正是这些排版与结构丢失。

在 NoteLoom 里哪些内容能完整保留

NoteLoom 针对 Obsidian 用户习惯设计,能够识别并保留常见的扩展标记:

你 Obsidian 笔记里的 NoteLoom 在一趟往返里做什么
Frontmatter(YAML 属性) 识别属性内容,保存时保留原有字段与结构
Callout 标注块( > [!NOTE] ) 正常渲染并支持折叠,保存时不退化成普通引用
[[wikilink]] 与 ![[embed]] 正常渲染与补全,保留链接路径、别名和块引用
Dataview / Tasks 插件块 显示为占位块,代码原文原样保留,放回 Obsidian 正常运行
空行与排版间距 保留原有空行和间距

尤其是 Dataview 和 Tasks 代码块:NoteLoom 本身不执行这类插件脚本,但会在编辑区把它完整保留并显示为占位块。你修改正文其他段落并保存后,代码原文不变,重新放回 Obsidian 打开,查询依旧照常输出。

更稳妥的编辑方式:source 源码视图

如果你想逐字确认修改、不想经过任何富文本层干扰,可以直接切换到 source 源码视图。这里直接呈现底层 Markdown 纯文本,你看到的就是文件里的原文。

而且你的笔记全程都是纯 .md 文件,改动直接写回原文件。你可以随时用别的文本工具或 Git 查看改动差异,看清一次编辑到底改了什么。

使用边界与做不到的事

  • 它能识别常见语法,但它不是 Obsidian 客户端。网页版虽然提供关系图谱(支持全局与当前笔记周边两种范围)和反向链接面板,但它没有插件生态、Canvas 白板、云端同步和手机端,也不读取 .obsidian 配置文件夹。第三方插件代码块只会原样保留,不会在页面里运行。
  • 所见即所得编辑侧重排版体验,而不是逐字节对比工具。虽然它能保留空行、排版间距与特殊标记,但如果你对文件每一个字符的变动有严格要求,建议切到 source 源码视图修改,并配合版本控制工具检查 diff。
  • 文件读写在本地浏览器内完成。通过浏览器的 File System Access API 直接读写你电脑上的文件,需要使用 Chrome、Edge 或 Arc 等桌面端浏览器。装成 PWA 后在离线状态下也能打开。

如果那台机器根本装不了 Obsidian,看 没管理员怎么用 Obsidian vault 和 不装 Obsidian 打开 vault。

FAQ

用别的编辑器改 .md 文件,开头的 frontmatter 会坏掉吗?
要看编辑器。有些编辑器不识别 YAML frontmatter,保存时可能会删掉或打乱属性顺序。NoteLoom 能识别 frontmatter,保存时会把它留着,放回 Obsidian 能照常识别。
Obsidian 里的双链和 callout 标注块,改完还能用吗?
能。NoteLoom 能正常渲染 [[wikilink]]、别名、块引用与 ![[嵌入]],也支持 Obsidian 默认的 13 种 callout 标注块并支持折叠。它不会在保存时删掉这些写法,重新放回 Obsidian 打开,结构和跳转都还在。
笔记里写的 Dataview 查询或 Tasks 代码块会被改动吗?
不会。NoteLoom 不运行这类插件代码,它会把源码原封不动留着,在页面上显示成占位块。保存时原文字符不会变动,放回 Obsidian 打开,查询依然按原样执行。
想直接查看和修改纯文本源码,可以吗?
可以。切换到 source 源码视图,就能看到没有任何富文本修饰的原始 Markdown。文件保存在本地,是标准的 .md 纯文本,改完之后你可以随时用 Git 或其他文本工具比对 diff,看清改动了哪几行。
NoteLoom 是想替代 Obsidian 吗?
不是。它能识别常用语法,网页版也提供全局和局部的关系图谱,但它没有插件系统、Canvas 白板、云端同步和手机端。它更适合当作你在其他电脑上临时编辑本地 .md 文件的轻量补充。
使用 NoteLoom 网页版需要什么浏览器?
支持电脑端 Chromium 架构的浏览器,比如 Chrome、Edge 和 Arc。因为它调用浏览器的 File System Access API 直接读写本地文件,Firefox、Safari 以及手机端浏览器目前无法使用。

换个环境改笔记,保留原有格式与链接

在网页端直接挂载本地 vault 文件夹,读写 .md 并直接保存回磁盘。保留 frontmatter、callout 标注与双链结构;需要细致校对时,随时切换到 source 源码视图直接修改,无需反复导入导出。

在浏览器中挂载本地 vault 文件夹 →