把 Obsidian 笔记直接搬进这个站

我在 Obsidian 里写东西，写完想直接扔进这个站，不想为了发布再手工改一遍语法。 这篇既是说明，也是这套支持的活体验收样本——你现在看到的每一种写法，都由构建期的插件翻译过。

双链

站内已有的文章可以直接用双链引用：折纸与流体：做这个站的笔记。 也可以给它换个说法：做这个站时踩的坑。 还能直接指到某个小节：折纸与流体：做这个站的笔记。

按标题写也认：为什么这个站没有用 React。

而指向一篇还没写的笔记时（Obsidian 里这太常见了），它不会变成一个点了 404 的链接， 而是降级成一段灰字：一篇我还没动笔的东西。草稿也一样，比如 还没写完的草稿 —— 草稿不发布， 链过去就是死链，所以它和「不存在」被一视同仁。

嵌入

图片可以直接嵌：

附件找不到时也不会留下破图标，只是一句克制的提示：缺少附件：根本没有这张图.png

Excalidraw

这是 Obsidian 的 Excalidraw 插件画的图，在构建期就被画成 SVG 了：

插件保存成 .excalidraw.md 的形态同样认——而且按 Obsidian 自己的写法引用即可 （插件插入的嵌入是 ![[名字.excalidraw]]，不带 .md，站里会自动补）：

画布坏掉时构建不会失败，只是这一处退成占位：画布无法渲染：broken.excalidraw

内联标签

正文里散落的 #写作流程 和 #Astro 会渲染成标签链接 —— 因为它们在这篇的 frontmatter 里。

而 #设计笔记 这种只在正文里出现过的标签没有对应页面，所以它降级成灰字而不是死链： 标签页的归属只看 frontmatter，正文里的内联标签不改变它，元数据只有一个来源。

这些则根本不是标签：主色是 #ff5fa2、锚点写法 example.com/#top、编号 #123。

高亮、折叠告示块与块引用

正文里的 重点可以高亮，写法就是 Obsidian 的双等号。

图片还能带尺寸，| 后面写数字就是宽度：

这一段被我在 Obsidian 里标了个块锚点，可以被别处精确引用。

引用它的写法是 [[文章#^锚点]]：把 Obsidian 笔记直接搬进这个站。 而指向一个不存在的锚点时，它和坏双链一样降级成不可点的灰字：把 Obsidian 笔记直接搬进这个站。

嵌入另一篇笔记（![[笔记名]]）本站不做——递归和内容重复的代价太大， 所以它会明确告诉你「不支持」，而不是含糊地说「缺少附件」：不支持嵌入笔记：origami-and-fluid

私密注释不会跟着发出来

Obsidian 里 %%…%% 是只给自己看的批注。它在构建期就被剔除了， 页面、页面源码、站内搜索索引里都不存在——所以从库里直接拷一篇带私人备忘的笔记过来是安全的。

注释里如果夹着空行，也照样整段消失：

代码块里的写法原样保留

这一点是这套实现最容易搞砸的地方——讲解语法的时候，示例代码不能被自己吃掉：

[[这是代码块里的双链，不该被改写]]
![[这也不该被改写.png]]
#这个井号也不是标签
%%这段注释也原样留着%%

行内代码同理：[[原样保留]]、#不是标签、%%也不是注释%%。