github - 找不到在 github 项目和用户页面上使用 Markdown 的详细、具体的文档

Question

我正在将 github 页面添加到我的一些存储库和我的用户页面。对于许多网页，我想使用 Markdown 格式。

但是，因为我只能找到 vague, undetailed关于如何做到这一点的信息，我正在反复试验以弄清楚它是如何工作的。

真正的文档在哪里？血腥的细节？

Here是迄今为止我找到的最好的信息，它说:

使用特殊的分支名称 gh-pages为项目存储库创建站点

文件顶部的三行咒语是必要的:

---
title: something
---

后缀更改为 .html

但是我对细节有很多疑问，例如:

我可以导入css文件吗？

那个“标题”简介实际上是做什么的？

文件需要什么后缀？

等等。所以我真的很想查看所有功能的详细文档。

请注意，这个问题不是关于如何使用 Markdown 语法，而是如何利用 github 的魔法在用户和项目页面范围内从 Markdown 自动创建 html。

Answer 1

仅具有扩展名的文件 .md或 .markdown将在 GitHub 用户页面上转换为 HTML。

带扩展名的文件 .html和 .textile根据我的尝试，没有翻译。

请注意，应避免使用 UTF8 编码。