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

Question

Hackage 已经能够显示 Markdown READMEs for a while .

但正如我们在 the Hackage page for hpack 上看到的那样，Hackage 似乎不支持与 GitHub 相同的表语法。

Markdown :

#### <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

快速search through the source的 Hackage 显示使用 cheapskate (作者约翰麦克法兰，潘多克的作者)。看着 Cheapskate.Types 您可以看到支持的所有内容 - 表格不是其中的一部分。

此外，Hackage has the raw HTML option for rendering set to False 似乎，从而消除了人们对放入一个简单的 HTML 表格的任何希望(我认为它也应该在 GitHub 中工作)。

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

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

它会呈现为

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