双链使用指南

支持的写法

网站构建时解析双链，Markdown 文件中仍保留 Obsidian 原始写法。

写法	用途
[[workflow]]	使用唯一文件名引用笔记
[[docs/companies/index|公司研究]]	仓库根路径和自定义显示文字
[[docs/about/workflow#创建公司笔记]]	指向其他笔记的标题
[[#支持的写法]]	指向本页标题

实际链接示例：公司研究、创建公司笔记、返回本节。

支持中文和日文文件名、可选的 .md 后缀，以及 aliases 字段声明的别名。文件名须真实存在；笔记标题与文件名不同时，可将标题加入 aliases，或直接使用完整路径。

同名笔记请使用以 docs/ 开头的路径。网站会拒绝缺失或无法唯一确定的目标，避免发布无法访问的链接。代码块和行内代码中的双链示例不会被解析。

反向链接

网站在文章底部显示「引用本页的笔记」，根据 docs/ 中的双链自动生成。Obsidian 的反向链接面板和关系图谱则由 Obsidian 自身维护，可以包含尚未发布的草稿。

附件与兼容范围

网站当前支持笔记链接、别名、标题链接和反向链接。图片使用标准 Markdown 相对路径，例如 ![图表说明](../assets/chart.png)，这在 Obsidian 中也可用。

Obsidian 的 ![[笔记嵌入]]、![[图片]] 和 [[笔记#^块引用]] 暂未实现网站渲染，检查时会报错。Obsidian callout、Dataview、Canvas 等扩展也不在本阶段的兼容范围内。后续迁移时应检查实际用法再补充支持。

不要从发布笔记双链到 writing/ 中的草稿；网站只为 docs/ 中的笔记生成页面。