如何将带Obsidian双括号引用的Markdown通过Sphinx生成可访问文档

零改造成本方案（优先推荐） #

• 不需要调整任何存量文档的[[文件名.md]]双链写法，直接选用原生支持Obsidian Wiki链接语法的静态文档生成工具，把整个Obsidian vault目录作为输入源即可。工具构建时会自动识别双括号引用，转换成对应静态页面的可点击跳转链接，生成的站点自带全文搜索、目录导航功能，非技术团队成员直接用浏览器访问即可，无需安装Obsidian客户端。
• 构建产出的纯静态文件可以直接托管在内网静态服务器、团队内部文件服务或者内网Pages平台，不需要额外部署复杂的后端服务。

保留现有Sphinx工作流的补全方案 #

• 不需要反复调试MyST-Parser、Recommonmark的兼容配置，只需要在Sphinx项目的conf.py配置文件中加一段轻量的自定义转换逻辑，在构建流程读取Markdown源文件时，自动把双括号格式的引用转换成Sphinx可识别的标准链接格式，不需要批量修改存量文档内容。
• 可直接复用的配置代码如下，不需要安装额外依赖：

import re
from sphinx.transforms import Transform

class ObsidianWikiLinkConvert(Transform):
    default_priority = 200
    def apply(self):
        # 匹配[[文件名.md]]格式的引用
        link_pattern = re.compile(r'\[\[([a-zA-Z0-9_\-/]+\.md)\]\]')
        for text_node in self.document.traverse(lambda n: hasattr(n, 'rawsource')):
            original_content = text_node.rawsource
            if not link_pattern.search(original_content):
                continue
            # 替换为标准Markdown相对链接格式
            converted_content = link_pattern.sub(r'[\1](\1)', original_content)
            text_node.rawsource = converted_content

def setup(app):
    app.add_transform(ObsidianWikiLinkConvert)

• 配置添加完成后，正常执行原有sphinx-build构建命令即可，所有双括号引用都会自动转为可正常跳转的链接。

极简免构建方案 #

• 如果需要最快上线，可以直接在vault根目录启动一个内网静态文件服务，注入一段轻量前端脚本：页面加载完成后自动遍历页面文本内容，匹配所有[[文件名.md]]格式的片段，替换为指向对应文档页面的超链接标签。整个流程不需要提前做全量文档构建，更新文档后直接刷新页面就能看到最新内容。

小提示：如果vault中存在不同目录下的同名文档，只需要在转换规则里补充一层文件路径索引匹配逻辑即可，不需要修改原有文档内的引用写法。

内容的提问来源于stack exchange，提问作者Toby Manders