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 上呈现:
所以,我想知道:
- Hackage 支持哪种 Markdown 方言?
- table 有那个方言的语法吗?
- table 的 Markdown 子集中是否有 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 |
+---------+---------+---------+
Hackage 已经能够显示 Markdown README for a while。
但是正如人们在 the Hackage page for 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 方言?
- table 有那个方言的语法吗?
- table 的 Markdown 子集中是否有 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 |
+---------+---------+---------+