我正在将 github 页面添加到我的一些存储库和我的用户页面。对于许多网页，我想使用 Markdown 格式。
但是，由于我只能找到有关如何执行此操作的模糊、不详细的信息，因此我正在反复试验以弄清楚它是如何工作的。
真正的文档在哪里？血淋淋的细节？
这是迄今为止我发现的最好的信息，上面写着：
- 使用特殊的分支名称
gh-pages为项目 repo 创建站点 文件顶部的三行咒语是必要的：
--- title: something ---- 后缀变为
.html
但我还有很多关于细节的问题，例如：
- 我可以导入css文件吗？
- 那个“标题”宣传实际上是做什么的？
- 文件需要有什么后缀？
等等所以我真的很想查看所有功能的详细文档。
请注意，这个问题不是关于如何使用 Markdown 语法，而是如何利用 github 的魔力在用户和项目页面范围内从 Markdown 自动创建 html。