md-to-html-converter 1.1

Convert Markdown files to self-contained HTML pages with GitHub-like styling

Read this in English | GitHub | PyPI

md-to-html-converter

md-to-html-converter — это Python-библиотека и CLI-утилита для конвертации Markdown-файлов (.md) в самодостаточные HTML-страницы (.html) с оформлением в стиле GitHub.

Возможности

• Полная поддержка Markdown — таблицы, блоки кода, списки, цитаты и всё остальное через библиотеку markdown с расширениями.
• Подсветка синтаксиса — блоки кода подсвечиваются с помощью Pygments (цветовые схемы, приближенные к GitHub).
• Тёмная и светлая темы — GitHub Dark (по умолчанию) и GitHub Light. Все стили встраиваются прямо в HTML-файл (self-contained).
• Эмодзи — шорткоды вида :smile: автоматически заменяются на Unicode-эмодзи (😄).
• Якорные ссылки — у каждого заголовка (<h1>–<h6>) появляется уникальный id и ссылка-якорь, видимая при наведении.
• Транслитерация — кириллические заголовки преобразуются в латинские slug-и (например, # Привет мир → privet-mir).
• Python API и CLI — используйте библиотеку в своём коде или вызывайте md-converter из терминала.

Установка

pip install md-to-html-converter

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

Python API

import md_to_html_converter as convert

# Конвертация файла (GitHub Dark)
convert.file("document.md", "document.html")

# Конвертация файла (GitHub Light)
convert.file("document.md", "document.html", theme="light")

# Конвертация строки
html = convert.convert("# Hello\n\nWorld!", theme="dark")
with open("page.html", "w", encoding="utf-8") as f:
    f.write(html)

CLI

# GitHub Dark (по умолчанию)
md-converter input.md output.html

# GitHub Light
md-converter input.md output.html --theme light

# Явное указание тёмной темы
md-converter input.md output.html --theme dark

Пример

Входной файл example.md:

# Привет, мир!

Это **пример** Markdown-документа.

| Имя  | Возраст |
|------|---------|
| Анна | 25      |
| Иван | 30      |

```python
def hello():
    print("Hello!")

Цитата с :smile:

**Команда:**

```bash
md-converter example.md example.html --theme dark

Результат: самодостаточный HTML-файл example.html с GitHub-подобным тёмным оформлением, подсветкой синтаксиса и якорными ссылками.

Требования

• Python 3.8 или выше
• Зависимости: markdown>=3.3, Pygments>=2.14, emoji>=2.0

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

md-to-html-converter/
├── pyproject.toml
├── LICENSE
├── README.md
├── README.en.md
└── src/
    └── md_to_html_converter/
        ├── __init__.py
        └── converter.py

Лицензия

Apache 2.0