我想知道是否有一个命令行实用程序可以将GitHub风味Markdown文件并将其呈现为HTML。
我正在使用GitHub维基创建网站内容。我已经在服务器上克隆了存储库，然后想把它处理成常规HTML。对我来说，重要的是，在GitHub上出现的内容正是我的网站应该如何寻找的。我也非常喜欢使用带~~~的围栏块，所以我宁愿不使用标准Markdown语法。
我已经看了一下JavaScript的实时预览，我想我可以把它挂钩到Node.js，但他们说它已经被弃用了。我已经查看了红地毯存储库，但它看起来不像有命令行界面。
我选择了自己的解决方案，但是，由于这里没有一个解决方案明显比其他解决方案更好，所以我将不选择答案。
当前回答
改进@barry- state的解决方案。将这段代码插入~/.bashrc中
function mdviewer(){
pandoc $* | lynx -stdin
}
然后，我们可以从命令行快速查看该文件。也可以很好地工作在SSH/Telnet会话。
mdviewer README.md
其他回答
阅读自述文件。md文件在终端我使用:
pandoc README.md | lynx -stdin
Pandoc以HTML格式输出，Lynx将其呈现在您的终端中。
它工作得很好:它充满了我的终端，快捷方式如下所示，我可以滚动浏览，链接也起作用了! 虽然只有一种字体大小，但颜色+缩进+对齐方式弥补了这一点。
安装:
Apt: sudo Apt -get install pandoc lynx Nix: Nix -shell -p pandoc lynx
GitHub(从那时起)开发了一个很好的模块化文本编辑器Atom(基于Chromium，并使用Node.js模块作为包)。
一个默认的预安装包Markdown预览让您显示您的预览在一个单独的选项卡使用Ctrl + Shift + M。
我还没有测试它的完整语法，但由于它来自GitHub，如果预览的语法与他们的不同(使用~~~工作的栅栏块)，我会非常惊讶。
现在，虽然它在技术上不是基于命令行，但它使用Node.js并输出到基于dom的渲染器，这可能会帮助任何试图在基于Node.js的web服务器上渲染基于GitHub语法的HTML的人，或者只是编辑她/他的README。md离线。
为此，我设法使用了一行Ruby脚本(尽管它必须放在单独的文件中)。首先，在每台客户端机器上运行这些命令一次，你将从下面的机器推送文档:
gem install github-markup
gem install commonmarker
接下来，在客户端镜像中安装这个脚本，并将其命名为render-readme-for-javadoc.rb:
require 'github/markup'
puts GitHub::Markup.render_s(GitHub::Markups::MARKUP_MARKDOWN, File.read('README.md'))
最后，像这样调用它:
ruby ./render-readme-for-javadoc.rb >> project/src/main/javadoc/overview.html
ETA:这不会帮助你与stackoverflow风味Markdown，这似乎是失败的答案。
在这条评论的基础上，我写了一个一行程序，使用curl和jq来访问Github Markdown API。
将这个bash函数粘贴到命令行或到~/.bash_profile中:
mdsee(){
HTMLFILE="$(mktemp -u).html"
cat "$1" | \
jq --slurp --raw-input '{"text": "\(.)", "mode": "markdown"}' | \
curl -s --data @- https://api.github.com/markdown > "$HTMLFILE"
echo $HTMLFILE
open "$HTMLFILE"
}
然后查看呈现的HTML在浏览器中运行:
mdsee readme.md
如果你需要一个纯终端解决方案，用lynx“$HTMLFILE”替换打开的“$HTMLFILE”。
参见https://softwareengineering.stackexchange.com/a/128721/24257。
如果你对我们(Github)如何渲染Markdown文件感兴趣，你可能想看看Redcarpet，我们的Ruby接口到Sundown库。
Ruby-script，使用Redcarpet，将是“命令行工具”，如果你有本地Ruby
