如何将 README.md 转换为 Github 样式的 HTML？

Question

我有一个 README.md 文件（描述 Node 应用程序），我需要将其转换为独立的 Github 样式的 README.html。

请注意，这与为 Github 风格的 Markdown 寻找 HTML 转换器不同。精确的风格很重要，独立的部分也很重要。 （这就是我的问题与this问题的不同之处）。

它可以是一个 npm 包或一个在线转换器，或者可能是一些（对我来说）晦涩难懂的 Github 功能，允许全屏查看 README.md，而不需要 Github 工具栏等。

如果有必要，我可以使用 Ruby gem 或其他语言/平台。它需要简单，因为我经常修改这个 README.md。

Answer 1

sublime text 2 有一个插件可以为你做到这一点，它非常准确

https://github.com/revolunet/sublimetext-markdown-preview

还有一个您可能感兴趣的 github markdown API：https://developer.github.com/v3/markdown/

还有 CSS：https://github.com/sindresorhus/github-markdown-css

Answer 2

我几天前才看到这篇文章。最后，我找不到任何可以满足我需求的工具，所以我决定创建自己的工具。

ghmd

(GitHub Markdown) 是一个最小的工具 (~4 KB)，可以使用 GitHub CSS 将任何 Markdown 文件转换为 HTML。它支持常规 Mardkown 和 GitHub Flavored Mardkown，以及自适应、浅色和深色模式。结果看起来就像在 GitHub 中一样。

要安装它，只需运行：

pip install ghmd

并转换任何文件：

ghmd README.md --embed-css

它将在与原始文件相同的目录中生成一个

README.html

。

--embed-css

标志会将 CSS 样式嵌入到 HTML 文件中，因此它是独立的。

我经常使用它来以 HTML 形式发送 Markdown 文件，它的作用就像一个魅力。