Obsidian · 兼容

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

你有一个 Obsidian vault,想(或不得不)在别处编辑其中一些 .md 文件:一台锁定的公司电脑、一台 Chromebook、或者只想快速改一处而不用打开整个库。真正的担心是:别的编辑器保存时会不会弄坏你的 frontmatter、callout 或 wikilink

这里讲一趟往返里到底什么能保住,以及怎么编辑才能让笔记在 Obsidian 里重新打开时照常工作。

一个粗心的编辑器会弄坏什么

一个不懂 Obsidian 风语法的编辑器,保存时可能:删掉或重排 YAML frontmatter、把 callout(> [!NOTE])退回成普通引用、搞乱 [[wikilink]]![[embed]]、或在 Dataview、Tasks 这类插件块上出岔子。每一个"这会不会弄坏我的库"的问题背后,都是这份担心。

在 NoteLoom 里什么能保住

NoteLoom 就是奔着 Obsidian-兼容做的,所以它理解并保留这些构造、而不是把它们压平:

你 Obsidian 笔记里的 NoteLoom 在一趟往返里做什么
Frontmatter(YAML 属性) 保留,当作兼容的属性
callout( > [!NOTE] ) 渲染、与 Obsidian 对齐,不退回成普通引用
[[wikilink]] 和 ![[embed]] 渲染并保留,不删掉
Dataview / Tasks 插件块 源码原样保留、显示成安全占位,在 Obsidian 里又照常运行
空行和间距 保留

Dataview 和 Tasks 那一行最能说明问题:NoteLoom 不执行这些块,但把它们的源码原样保留、显示成一个安全占位,所以你把笔记放回 Obsidian 打开,那些查询又照常运行、像什么都没发生过。

最稳的办法:source 视图

当你想对一处编辑有精确控制时,用 source 视图,它原样显示并编辑原始 Markdown——和 Obsidian 会给你看的是同一段文本。中间没有渲染层,就是文件本身。

而且因为你的笔记全程都是纯 .md,没有东西被藏起来:你可以在任意别的编辑器里打开这个文件核对、或者把库放进版本控制,看清一次编辑之后到底改了什么。这才是真正的安全网。

诚实的边界

  • 它理解 Obsidian 语法,但它不是 Obsidian。插件不运行(它们的块被保留、不被执行),也没有 canvas、图谱或同步。
  • 它是渲染编辑器,不是逐字节 diff 工具。它保留你的构造和间距,但如果你要一份字符级精确的 diff,就在 source 视图里改、并用版本控制核对文件。
  • 它是本地的。它不改写你的笔记,文件在 Chromium 桌面浏览器(Chrome / Edge / Arc)里本地读取;Firefox、Safari、手机端暂不支持。

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

FAQ

在别的 app 里编辑我的 Obsidian 笔记会搞坏 frontmatter 吗?
看 app。一个不懂 YAML frontmatter 的编辑器可能把它删掉或重排。NoteLoom 把 frontmatter 当作兼容的属性对待、保留它,所以它能安全往返回 Obsidian。
callout 和 wikilink 能保住吗?
在 NoteLoom 里能。它渲染与 Obsidian 对齐的 callout(> [!NOTE])、渲染 [[wikilink]] 和 ![[embed]] 而不是把它们删掉,所以你在 Obsidian 里重新打开时它们照常工作。
我的 Dataview 或 Tasks 块会怎样?
NoteLoom 不运行它们(它不是 Obsidian),但它把源码原样保留、显示成一个安全占位。你把笔记放回 Obsidian 打开,这些块又照常工作。没有东西被执行或改写。
我怎么做一处精确的编辑?
用 source 视图,它原样显示并编辑原始 Markdown。而且因为文件全程是纯 .md,你还能在任意别的编辑器里核对它、或把库放进版本控制看清到底改了什么。
这是 Obsidian、还是它的替代?
不是。它理解并保留 Obsidian 风的语法,但没有插件、canvas、图谱或同步。它是安全地读写 .md 文件的办法,不是完整的 app。
需要什么浏览器?
Chromium 系桌面浏览器:Chrome、Edge、Arc。它用浏览器的 File System Access API,Firefox、Safari 和手机端浏览器目前还不支持。

编辑你 vault 的笔记,又不把它们搞坏

用 Chrome / Edge / Arc 打开 NoteLoom,挂载你的 vault 文件夹,编辑那些 .md 文件、frontmatter/callout/wikilink 都保住,想精确改时用 source 视图。直接存回、仍是纯 Markdown,不用装、不用账号。

打开 NoteLoom 试试