haskell - Hackage 使用哪种 Markdown 方言来呈现 README？

Question

Hackage 能够显示 Markdown README 已经有一段时间了。

但是，例如在Hackage 页面hpack上可以看到，Hackage 似乎不支持与 GitHub 相同的表语法。

降价：

#### <a name="flags"></a>Flags

| Hpack | Cabal | Default | Notes |
| --- | --- | --- | --- |
| `description` | `description` | | Optional |
| `manual` | `manual` | | Required (unlike Cabal) |
| `default` | `default` | | Required (unlike Cabal) |

在 GitHub 上渲染：

在 Hackage 上渲染：

所以，我想知道：

• Hackage 支持哪种 Markdown 方言？
• 该方言中的表格是否有语法？
• GitHub 和 Hackage 都支持 Markdown 子集中的表格语法吗？

Answer 1

快速搜索Hackage 的源代码显示使用cheapskate（由 Pandoc 的作者 John MacFarlane 撰写）。查看Cheapskate.Types您可以看到所有受支持的内容 - 表格不是其中的一部分。

此外，Hackage 似乎将用于呈现的原始 HTML 选项设置为False，从而打消了人们对放置一个简单的 HTML 表的任何希望（我认为它也应该在 GitHub 中工作）。

我认为最好的选择（Hackage 和 GitHub 都支持）就是把你的表放在一个代码块中。这样，它至少是等宽字体（因此列可以对齐）。这意味着您输入类似

```
| Header1 | Header2 | Header2 |
+---------+---------+---------+
| Cell1   | Cell2   | Cell3   |
+---------+---------+---------+
```

它会呈现为

| Header1 | Header2 | Header2 |
+---------+---------+---------+
| Cell1   | Cell2   | Cell3   |
+---------+---------+---------+