我想知道是否有一个命令行实用程序可以将GitHub风味Markdown文件并将其呈现为HTML。
我正在使用GitHub维基创建网站内容。我已经在服务器上克隆了存储库，然后想把它处理成常规HTML。对我来说，重要的是，在GitHub上出现的内容正是我的网站应该如何寻找的。我也非常喜欢使用带~~~的围栏块，所以我宁愿不使用标准Markdown语法。
我已经看了一下JavaScript的实时预览，我想我可以把它挂钩到Node.js，但他们说它已经被弃用了。我已经查看了红地毯存储库，但它看起来不像有命令行界面。
我选择了自己的解决方案，但是，由于这里没有一个解决方案明显比其他解决方案更好，所以我将不选择答案。
当前回答
有一个非常好的和简单的工具来浏览GFM Markdown文档:
GFMS - Github调味Markdown服务器
它是简单和轻量级的(不需要配置)HTTP服务器，您可以在任何包含标记文件的目录中启动以浏览它们。
特点:
全GFM Markdown支持 源代码语法突出显示 浏览文件和目录 漂亮的输出(以及可配置的CSS样式表) 导出为PDF
其他回答
我使用Pandoc选项——from=gfm为GitHub调味Markdown如下:
$ pandoc my_file.md --from=gfm -t html -o my_file.html
最新的添加，但showdownjs有一个CLI工具，您可以使用它将MD解析为HTML。
我还没有找到一个快速和简单的方法，github风味Markdown，但我已经找到了一个稍微更通用的版本- Pandoc。它可以从/转换为多种格式，包括Markdown, Rest, HTML和其他格式。
我还开发了一个Makefile来将所有。md文件转换为。html(在很大程度上是Writing, Markdown和Pandoc的例子):
# 'Makefile'
MARKDOWN = pandoc --from gfm --to html --standalone
all: $(patsubst %.md,%.html,$(wildcard *.md)) Makefile
clean:
rm -f $(patsubst %.md,%.html,$(wildcard *.md))
rm -f *.bak *~
%.html: %.md
$(MARKDOWN) $< --output $@
我找到了一个网站，可以帮你做到这一点:http://tmpvar.com/markdown.html。粘贴你的Markdown，它会为你显示它。它似乎工作得很好!
然而，它似乎不能处理代码的语法高亮显示选项;也就是说，~~~ruby特性不起作用。它只打印‘ruby’。
我用Python写了一个小的CLI，并添加了GFM支持。它叫做Grip (Github Readme即时预览)。
安装方法:
$ pip install grip
要使用它，简单地说:
$ grip
然后访问localhost:5000查看自述文件。Md文件在那个位置。
你也可以指定你自己的文件:
$ grip CHANGES.md
并更改端口:
$ grip 8080
当然，特别渲染github - flavour Markdown，可选的存储库上下文:
$ grip --gfm --context=username/repo issue.md
显著的特点:
渲染页面显示完全像在GitHub Fenced块 Python API 在2.0中添加的链接文件(谢谢vladwing!)之间导航 导出到2.0中添加的单个文件(谢谢，iliggio! 新增:从stdin读取并导出到stdout
来看看。
