17 — Продвинутый Markdown

Глава 06 описывает основы. Эта глава — дополнения, которые сервер тоже отображает; каждое из них проверено на этой установке.

Списки задач

- [x] черновик написан
- [ ] ждёт проверки

Работает в задачах и в файлах .md; галочки показываются только для чтения.

Короткие имена эмодзи

:tada: :rocket: :warning:

Отображается как 🎉 🚀 ⚠️. Вставить эмодзи напрямую тоже можно.

Сноски

У этого утверждения есть источник[^1]

[^1]: Откуда взято утверждение.

В тексте появляется надстрочный номер, внизу страницы — связанная сноска.

Математика

В строке $E = mc^2$ или блоком:

```math
\frac{a}{b} = c
```

Формулы набираются в браузере; исходник остаётся обычным текстом, поэтому git diff читаем.

Диаграммы

```mermaid
graph TD
  A[Запрос] --> B{Одобрено?}
  B -- да --> C[Слить]
  B -- нет --> D[Исправить]
```

Блок-схемы, диаграммы последовательности и Гантта рисуются из текста. Файла-картинки нет, поэтому диаграмма тоже попадает в историю — изменение видно в git diff.

Таблицы, зачёркивание, автоссылки

| Столбец | Значение |
|---------|----------|
| `main`  | ветка по умолчанию |

~~отменено~~ и голый адрес: https://forge.kabaforce.com

Адрес превращается в ссылку даже без скобок.

Ссылки на задачи и людей

В задачах и полях комментариев:

#12 → ссылка на эту задачу
@пользователь → ссылка на человека и уведомление ему
Fixes #12 в кратком сообщении коммита → закрывает задачу, когда изменение попадает в main (глава 11)

Где что работает

Место	Примечание
Файлы `.md`	Всё; `readme.md` автоматически показывается на странице каталога
Задачи и комментарии	Всё, плюс файлы можно перетащить как вложение
Страницы вики	Всё, со своей историей (глава 11)
Заметки к выпуску	Всё (глава 12)

Две привычки

Пользуйтесь вкладкой предпросмотра — до коммита видно ровно то, что увидят другие.
По одному предложению на строку в длинных документах — различия читаются построчно, а не красят весь абзац.