github - 生成带有导航元素的 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 的工具，我还没有研究过。