如何使用对其他标记[Obsidian，Sphinx]的双括号引用生成标记文档？

Question

我有一个版本控制的黑石金库，里面有很多我的项目的文档。这些文档具有对其他文档的双括号引用，如：

有关更多信息，请参见[Roadmap.md]。

我希望我的文档能被我的团队中的任何人托管和访问，包括不想安装Obsidian的非技术人员。我尝试过使用MyST-Parser和Recommonmark的各种配置来生成狮身人面像，但无法像我希望的那样获得交叉引用来转换为构建的文档中的链接。

有什么简单的方法可以做到这一点吗？

Answer 1

我还广泛使用狮身人面像和黑子狮身人面像用于各种出版物。我发现它是发布文档的一个很好的生态系统。我最近遇到了同样的问题，所以我试了试.

您可以通过运行以下命令来安装它: pip install --user git+https://github.com/MacqGit/sphinx-obsidian.git@main#egg=sphinx-obsidian

然后，在狮身人面像"conf.py ->扩展“中，只需将'myst_parser‘替换为'sphinx_obsidian’并运行一个简单的编译。“[]”应该很好地编译。

请原谅，因为这是第一次尝试(也是我第一次尝试通过在GitHub上发布来提供帮助;-)。而且，解决方案也不是很好，因为Myst/markdown实现不允许轻松扩展狮身人面像环境中的“mdit_py_plugins”功能.

如果有什么麻烦你可以再联系我..。