生成带有导航元素的 github 页面

Question

我在 github 上有一个项目，其中包含许多 markdown 文件（简介、用户指南、示例、参考）。

我想使用基于这些文件的 Github Pages 创建一个网站，其中还包含某种导航元素，例如包含指向所有生成页面的链接的简单侧边栏。

使用 Github Pages 生成的开箱即用的页面似乎都是独立的，无法在它们之间导航。

有没有一种简单的方法可以实现这一点，或者这个用例对于 github 页面来说太复杂了？在这一点上，文档似乎缺乏。

Answer 1

Markdown 链接到同一文件夹中的页面

[__PageA__](PageA.md)
[__PageB__](PageB.md)

要链接到其他文件夹中的页面，只需输入相对链接，如下所示

[__PageC__](FolderC/PageC.md)
[__PageX__](../../PageX.md)

这适用于 GitHub 上托管的文件...然后如何使用这些文件生成独立网站，您需要一个将 Markdown 转换为 HTML 的工具，我还没有研究过。