通过 Pandoc 在 GitHub 上的降价表答案

【问题标题】：markdown tables on GitHub via Pandoc通过 Pandoc 在 GitHub 上的降价表
【发布时间】：2014-01-18 13:40:31
【问题描述】：

当我使用 Pandoc 将多个 .md 文件与表合并为一个 .pdf 和一个 .md 文件时，只有 .pdf 保持格式。我创建了一个简单的repository，它有四个.md 文件，显示Pandoc website 上的每个表示例。

我使用以下命令编译：

pandoc -o README.md *.md

pandoc -o README.pdf *.md

从存储库中可以看出，(pdf) 看起来不错，但降价文件 showing on GitHub as the readme 却不行。

此外，在四个单独的 .md 文件中，只有 pipe table 在 GitHub 上正确显示。

问题：

GitHub 支持哪些类型的降价表？此spec sheet 中未涉及表格。
Pandoc 似乎是 the best way to combine multiple .md files 到一个文档中，但输出到 .md 时格式不成立。 .pdf 看起来不错。为什么？有解决办法吗？

【问题讨论】：

【解决方案1】：

你说得对，GitHub 文档没有说明 GFM 支持哪种表。我认为您的测试表明它支持管道表。由于 Pandoc 可以原生输出 GFM（见下文），这可能是您最好的选择。
您可以使用-t 选项指定精确的输出格式。在这种情况下：
```
 pandoc -o whole-thing.md -t gfm *.md
```
列出了支持的输出格式in the Pandoc README。

【讨论】：

问题是GitHub不支持Pandoc输出为Markdown的表格格式。我会调整我的答案以使用你的新文件名。
其实Pandoc可以输出GFM支持的表。再次更新。
就是这样！ cat *.md > whole-thing.md 保持正确的管道表格式，pandoc -o whole-thing-gfm.md -t markdown_github *.md 解决了这个问题。我跑了这两个并致力于 github 作为其他人寻找答案的例子。
使用-t markdown_github时，it looks like other input table types都可以。不仅仅是管道表。 pandoc 似乎进行了转换。