Таблицы отлично работают в предварительном просмотре Markdown, когда синтаксис правильный. Проблема в вашем коде в том, что выравнивание ячеек таблицы, в частности, вертикальных линий.
Это должно выглядеть примерно так:
| | OCaml | JavaScript |
|--------------|---------------------|----------------------|
| numbers | no longs or shorts | has longs and shorts |
| empty values | called unit | called null |
Это имеет смысл несколькими способами: таблица правильно выровнена в текстовом режиме и будет работать в режиме предварительного просмотра HTML. Другими словами, оно следует основной философии Markdown:
Markdown предназначен для того, чтобы быть таким же легким для чтения и легким для записи, как
возможно.
Однако удобочитаемость подчеркивается превыше всего.
Документ в формате уценки должен быть опубликован как есть, как простой
текст, не смотря на то, что он был размечен тегами или форматированием
инструкции.
Джон Грубер, изобретатель Markdown
Можно быть ленивым, вы все равно можете следовать спецификации, используя инструменты, которые облегчают вашу жизнь, например, Пакеты Atom, такие как markdown-table-editor .