Markage使用哪种方法来管理自述文件？

Question

Hackage已经能够显示Markdown自述文件一段时间了.

但是正如人们可以在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   |
+---------+---------+---------+