在 Github 中创建 github.io 配置文件时 .md .html .rmd 文件有啥区别？

Posted 2023-03-28

【中文标题】在 Github 中创建 github.io 配置文件时 .md .html .rmd 文件有啥区别？

【英文标题】：In Github when creating github.io profile what the difference of .md .html .rmd files?在 Github 中创建 github.io 配置文件时 .md .html .rmd 文件有什么区别？

【发布时间】：2021-12-28 08:37:26

【问题描述】：

我正在尝试创建github.io 个人资料。

我可以知道 .md .html .rmd 文件之间的区别吗？

例如，我看到相同的文件名具有不同的文件类型，例如 Readme.md vs Readme.html XXX.rmd vs XXX.html

【问题讨论】：

在我把这个作为答案之前，仍在为你寻找一个好的资源——但简而言之，github.io（又名 Github 页面）使用名为 Jekyll 的软件来收集 html（以及 css）文件来构建网站（通常由 html 和 css 文件描述的网站）。 Markdown 文件（.md 或 .rmd 用于相关的 R-markdown）是在 github 和其他地方用于生成文档的文件，Jekyll 也会读取这些文件来为生成的网站的其他页面构建 html。

谢谢@SamBob 我几乎不明白这一点:) — 为了简单起见，我可以知道如果我只创建 HTML 文件并将它们上传到 GitHub，我可以创建个人资料吗？我还需要创建其他文件吗？

你不需要使用 markdown 文件——它们可以替代 html （尽管它们比 html 更容易编写来生成文档）。这里的说明：jmcglone.com/guides/github-pages 向您展示如何使用 html 制作 github pages 站点。当您到达Using Jekyll with GitHub Pages 部分时停止，因为这里介绍了使用 markdown 代替 html 或与 html 并排使用，您不需要使用它！

如果您以后确实想尝试创建 Markdown 文件而不是 html，stackedit.io 是一个有用的创建工具。

没问题，我总结了这些cmets作为答案，如果对你有帮助，如果你能接受它作为答案，我将不胜感激！

【参考方案1】：

github.io（又名 Github 页面）可以从任何一个创建网站

html 可选 css Markdown 文件（.md 和 .rmd） 以上的组合

它使用一组名为 Jekyll 和 kramdown 的工具将 markdown 文件转换为 html 以作为网站的一部分显示。

Markdown 文件是一种文件格式，通常用于在类似网站上的 github 中生成文档，并且为此目的比 html 具有 mopre 简化的语法。你可以试试https://stackedit.io

然而，Github 页面的降价使用是完全可选的，如果你愿意，你可以只使用 html。您可以按照https://jmcglone.com/guides/github-pages 的指南向您展示如何使用 html 制作 github 页面站点。如果您不想合并任何降价，请在到达将 Jekyll 与 GitHub Pages 结合使用部分时停止。