问题描述
我想创建一个要点,我可以在其中展示一个包含一组链接的主要 Markdown 文档。这些链接将指向实际包含代码示例和技术说明的二级降价:
Here's 到目前为止我所拥有的。我已经包含了两个降价文件:
-
Notes.md
:包含现有二级降价文档的列表 -
tree_traversal.md
:此类二级降价的示例
如您所见,我尝试使用以下语法在 Notes.md
中添加到 tree_traversal.md
的链接:
example of a [link](tree_traversal.md)
但是有两个问题:
- Gist 服务器尝试同时显示
Notes.md
和tree_traversal.md
。这不是我想要的。我想先显示Notes.md
,然后点击链接导航到tree_traversal.md
- 当我实际点击我在
Notes.md
中创建的链接时,我收到了 404 Page not found 错误。
有可能有这样的多页要点吗?如果是这样怎么办?如果不是,gist 是否只设计了一个 Markdown 文件?
解决方法
将鼠标悬停在 tree_traversal.md
标题上,我们看到它是一个链接
https://gist.github.com/awa5114/4052ba8adb51779192a4a715a048f8ca#file-tree_traversal-md
尝试简单地链接到 #file-tree_traversal-md
中的 Notes.md
。这应该可以让您在文件之间进行链接,尽管它们仍然会在单个视图中呈现。
要点旨在用于快速片段,而不是文档。也许您正在寻找GitHub wikis? Wiki can be cloned via Git,managed locally,and pushed back,它们一次呈现一个页面。
或者可能是 GitHub Pages,它可用于托管静态网站?