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

Question

我正在将github页面添加到我的一些repos和我的用户页面中.对于许多网页,我想使用Markdown格式.

但是,由于我只能找到关于如何执行此操作的模糊,无详细信息,因此我正在进行反复试验以确定其工作原理.

真正的文件在哪里？血淋淋的细节？

---

以下是我迄今为止发现的最佳信息,其中说:

• 使用特殊分支名称gh-pages为项目仓库创建站点

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

  ---
  title: something
  ---
  

• 后缀变为 .html

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

• 我可以导入css文件吗？
• 这个"标题"模糊实际上做了什么？
• 文件需要具有什么后缀？

所以我真的很想看到所有功能的详细文档.

---

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

Answer 1

只有扩展名为.md或 的文件.markdown才会在 GitHub 用户页面上转换为 HTML。

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

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