Какой диалект Markdown использует Hackage для визуализации README?

Question

Hackage уже некоторое время может отображать README Markdown.

Но, как можно увидеть, например, на странице Hackage для 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:

Итак, мне интересно:

• Какой диалект Markdown поддерживает Hackage?
• Есть ли синтаксис для таблиц на этом диалекте?
• Существует ли синтаксис для таблиц в подмножестве Markdown, который поддерживается как GitHub, так и Hackage?

Answer 1

Быстрый поиск по источнику Hackage показывает, что использует cheapskate (Джон Макфарлейн, автор Pandoc). Глядя на Cheapskate.Types Вы можете видеть все, что поддерживается - и таблицы не являются частью этого.

Кроме того, кажется, что Hackage имеет необработанный параметр HTML для рендеринга, установленный на False тем самым уничтожая любую надежду на простую HTML-таблицу (которая, я думаю, должна работать и в GitHub).

Я думаю, что лучшая альтернатива (поддерживаемая Hackage и GitHub) - это просто поместить вашу таблицу в блок кода. Таким образом, это как минимум моноширинный шрифт (чтобы столбцы могли выравниваться). Это означает, что вы вводите что-то вроде

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

И это будет отображаться как

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