md2gost

Конвертер Markdown в LaTeX по ГОСТ Р 7.0.5-2008. Генерирует PDF-отчёты с титульным листом, содержанием, нумерацией и форматированием по ГОСТ.

Установка

Требуется Docker. Локальная установка LaTeX не нужна.

docker build -t md2gost .

Использование

./md2gost.sh report.md -o ./build

Скрипт создаст build/report.tex и build/report.pdf.

Флаги

• -o dir -- выходная директория (по умолчанию ./build)
• --no-pdf -- только .tex, без компиляции

Формат Markdown

Используется front matter в начале файла:

---
факультет: Информатика и системы управления
кафедра: Программные средства
тип: Отчёт по практике
название: Исследование алгоритмов оптимизации
студент: Иванов И.И.
преподаватель: Петров П.П.
группа: ИУ1-12
год: 2026
---

Обязательные поля: название, тип.

Поддерживаемые элементы

• Заголовки (1-3 уровень) с нумерацией
• Параграфы, списки (маркированные и нумерованные)
• Таблицы
• Код с подсветкой синтаксиса
• Изображения
• Аббревиатуры (раздел "Перечень принятых сокращений")
• Ссылки, жирный, курсив

Структура проекта

md2gost/
  md2gost/
    main.py          # точка входа
    parser.py        # парсинг markdown
    render.py        # рендер в LaTeX
    handlers/        # обработчики блоков
    latex/           # преамбула, титульный лист
  md2gost.sh         # обёртка для Docker
  Dockerfile
  Makefile

Команды

make build    # сборка Docker-образа
make run      # сборка + конвертация report.md
make format   # форматирование кода (black + ruff)
make tidy     # статический анализ (ruff + mypy)