Понятия
Почему LibreTimes Markdown устроен именно так — связь с CommonMark, утверждения и выноски, отображение, книги и запрещённый HTML.
Эти страницы объясняют диалект, а не перечисляют его. Читайте их, когда правило вас удивило, или перед большой работой: тогда правила выглядят следствиями нескольких решений, а не списком, который надо запомнить.
| Страница | На какой вопрос отвечает |
|---|---|
| LibreTimes Markdown и CommonMark | Что стандартно, что добавлено, что изменено и от чего диалект отказывается |
| Утверждения и выноски | Почему теорема и предупреждение — разные вещи и почему нумеруется только одна из них |
| Как отображается документ | Что происходит между исходным текстом и страницей, почему математика на KaTeX и почему предпросмотр совпадает со страницей |
| Как устроена книга | Главы как страницы, части как навигация и адреса, которые никогда не меняются |
| HTML и безопасность | Какой сырой HTML может быть в документе и почему остальное удаляется |
За большинством из них стоит одно предложение: разметка говорит, что такое вещь, и никогда — как она выглядит. Теорема помечается как теорема, а полужирная метка и курсив следуют из этого. Строка по центру помечается как строка по центру, а не как отступ определённой ширины. Каждая страница показывает, к чему это приводит.