Sergey Filkin
54 lines
1.4 KiB
Markdown
54 lines
1.4 KiB
Markdown
# md-to-html
|
|
|
|
Сервис конвертации Markdown в самодостаточный HTML (через GitHub API).
|
|
|
|
Часто нужен адекватно (минималистично) выглядящий HTML из Markdown. HTML получем через открытый API GitHub, а стили просто захардкожены в шаблоне.
|
|
|
|
|
|
|
|
GITHUB_TOKEN не нужен, если не требуется массовая (поточная) конвертация. Но если нужно, то его можно передать через переменную окружения при запуске.
|
|
|
|
Есть два интерфейса:
|
|
|
|
- FastAPI на `http://localhost:8000`
|
|
- Streamlit UI на `http://localhost:8501`
|
|
|
|
## Локальный запуск
|
|
|
|
```bash
|
|
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 сохранился:
|
|
|
|
```bash
|
|
python3 md_to_html.py /path/to/file.md
|
|
```
|
|
|
|
## Docker
|
|
|
|
```bash
|
|
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`
|
|
|
|
```bash
|
|
curl -X POST http://localhost:8000/convert \
|
|
-H 'Content-Type: application/json' \
|
|
-d '{"markdown":"# Hello"}'
|
|
```
|
|
|
|
`GET /health`
|
|
|
|
```bash
|
|
curl http://localhost:8000/health
|
|
```
|