0

我可以在多个相互引用的 .md 文件中编写文档,然后使用像 Dillinger 这样的工具将所有这些 .md 文件转换为多个相互引用的 html 页面吗?

即我可以自动(使用 Dillinger 或 Stackedit 或任何其他软件)从

docs/readme.md  (with links to feature1.md and details.md)
docs/features/feature1.md (with link to readme.md)
src/details.md (with link to readme.md)

docs/readme.html (with links to feature1.html and details.html)
docs/features/feature1.html (with link to readme.html)
src/details.html (with link to readme.html)

这样我就可以在我编写的软件上构建和维护在线文档,并期望用户可以通过以下方式访问文档:

  • 直接读取插入到我的源中的 .md 文件,或者,

  • 每当我发布/更新我的软件时,在他们的浏览器上可视化我将从 .md 文件生成的 html 文档

4

1 回答 1

0

使用该选项的 mkdocsuse_directory_urls: false在运行时正是这样做的mkdocs build

于 2019-10-01T19:51:46.850 回答