Metadata-Version: 2.4
Name: md-to-html-converter
Version: 1.1
Summary: Convert Markdown files to self-contained HTML pages with GitHub-like styling
Project-URL: Homepage, https://github.com/KusokMedi/Markdown-to-site
Project-URL: Repository, https://github.com/KusokMedi/Markdown-to-site
Author: MD-to-HTML Converter Team
License: Apache-2.0
License-File: LICENSE
Keywords: converter,documentation,github-theme,html,markdown
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Natural Language :: Russian
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing :: Markup :: Markdown
Requires-Python: >=3.8
Requires-Dist: emoji>=2.0
Requires-Dist: markdown>=3.3
Requires-Dist: pygments>=2.14
Description-Content-Type: text/markdown

[Read this in English](README.en.md) | [GitHub](https://github.com/KusokMedi/Markdown-to-site) | [PyPI](https://pypi.org/project/md-to-html-converter/)

# 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` из терминала.

## Установка

```bash
pip install md-to-html-converter
```

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

### Python API

```python
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

```bash
# 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
# Привет, мир!

Это **пример** 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
