md-to-html/README.md

md-to-html

Сервис конвертации Markdown в самодостаточный HTML (через GitHub API).

Часто нужен адекватно (минималистично) выглядящий HTML из Markdown. HTML получем через открытый API GitHub, а стили просто захардкожены в шаблоне.

GITHUB_TOKEN не нужен, если не требуется массовая (поточная) конвертация. Но если нужно, то его можно передать через переменную окружения при запуске.

Есть два интерфейса:

• FastAPI на http://localhost:8000
• Streamlit UI на http://localhost:8501

Локальный запуск

uv venv .venv
source .venv/bin/activate
uv pip install -r requirements.txt
uvicorn app.api:app --reload
streamlit run app/streamlit_app.py

CLI сохранился:

python3 md_to_html.py /path/to/file.md

Docker

docker build -t md-to-html .
docker run --rm -p 8000:8000 -p 8501:8501 -e GITHUB_TOKEN=your_token md-to-html

API

POST /convert

curl -X POST http://localhost:8000/convert \
  -H 'Content-Type: application/json' \
  -d '{"markdown":"# Hello"}'

GET /health

curl http://localhost:8000/health