Hackage 使用哪种 Markdown 方言来呈现 README?

Which dialect of Markdown does Hackage use to render READMEs?

Hackage 已经能够显示 Markdown README for a while

但是正如人们在 the Hackage page for hpack 上看到的那样,Hackage 似乎不支持与 GitHub.

相同的 table 语法

降价:

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

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

在 GitHub 上呈现:

在 Hackage 上呈现:

所以,我想知道:

快速 search through the source of Hackage shows that is uses cheapskate (by John MacFarlane, the author of Pandoc). Looking at the Cheapskate.Types 您可以看到支持的所有内容 - table 不在其中。

此外,看起来 Hackage has the raw HTML option for rendering set to False,从而消除了任何希望放入一个简单的 HTML table(我认为它也应该在 GitHub).

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

的内容
```
| Header1 | Header2 | Header2 |
+---------+---------+---------+
| Cell1   | Cell2   | Cell3   |
+---------+---------+---------+
```

它将呈现为

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