ФОРМАТ · TEXT
Markdown
Текстовая разметка документации и заметок.
- Расширения
- md, markdown
- MIME type
- text/markdown
- Представление
- text
- Потоковая обработка
- да
- Комментарии
- нет
- Поддержка схемы
- Обычно нет; возможны внешние ограничения
- Порядок
- Порядок текста значим
- null
- Не применяется
- Diff
- Отличная при стабильном переносе строк
- Архивация
- Укажите диалект и сохраните вложения
Преимущества
- Исходник пригоден для чтения без рендера
Ограничения
- Расширения и встроенный HTML обрабатываются по-разному
- Приведённая команда проверяет чтение или разбор; она не заменяет специализированный валидатор языка.
Типичные ошибки
- Ожидать одинаковый вывод разных движков
Маленький пример
# Каталог
Запись: **Сосна**.
Среда: Python 3; только чтение UTF-8, не проверка диалекта Markdown.
python3 -c "from pathlib import Path; print(Path('example.md').read_text(encoding='utf-8'))"