013 · Obsidian wikilink 在 MkDocs 不生效

问题现象

笔记中大量使用 [[wikilink]]，在 notes（MkDocs）中 不可点击或无法解析。

排查过程

对照 MkDocs 默认 Markdown 特性与 Obsidian 语法差异；检查首页导航是否依赖 wikilink。

根因

写作语法与 发布语法 不一致；MkDocs 不内置 Obsidian 双链解析。

改进计划

发布层采用 标准 Markdown 相对链接；首页可用 Material 组件（如 cards）组织入口；长期可借助构建前转换或插件（若引入需评估维护成本）。

经验教训

项目早期就列 「发布检查：链接、附件路径、wikilink」，避免后期批量返工。