Комплект для публикации документации

## Обзор
Комплект для публикации документации предоставляет единый рабочий процесс для превращения черновых технических заметок в готовую к публикации документацию: создайте содержание, очистите структуру markdown, а затем экспортируйте готовый HTML для распространения.

## Быстрый старт
1. Начните с `documentation`, когда вам нужно написать или переработать планы, предложения, спецификации, README, заметки, руководства или другие документы в формате markdown.
2. Запустите `baoyu-format-markdown` на черновике, чтобы очистить frontmatter, заголовки, резюме, подзаголовки, жирный текст, списки и блоки кода. Он выводит отформатированный файл `{filename}-formatted.md`.
3. Используйте `baoyu-markdown-to-html`, когда готовому markdown нужен стилизованный HTML-вывод, включая поддержку подсветки синтаксиса кода, математики, PlantUML, сносок, оповещений и контента для инфографики.

## Основные команды
- `documentation` — Создание структурированных документов, таких как спецификации, README, предложения, планы, заметки, руководства и файлы markdown.
- `jimliu-baoyu-format-markdown` / `baoyu-format-markdown` — Форматирование простого текста или markdown в более чистую структуру документа с заголовками, списками, frontmatter и типографикой.
- `jimliu-baoyu-markdown-to-html` / `baoyu-markdown-to-html` — Преобразование завершённого markdown в стилизованный HTML для веб-публикации или публикации богатого контента.

## Советы
- Соблюдайте последовательность рабочего процесса: пишите с помощью `documentation`, полируйте с помощью `baoyu-format-markdown`, затем публикуйте с помощью `baoyu-markdown-to-html`.
- Используйте отформатированный markdown-вывод как единственный источник перед преобразованием в HTML, чтобы README, спецификации и опубликованная страница оставались согласованы.
- Для технической документации с диаграммами или математикой сначала завершите markdown, а затем позвольте `baoyu-markdown-to-html` обработать PlantUML, математику, сноски, оповещения и подсветку синтаксиса кода в HTML-экспорте.