Converter Bot · md2gost
Русский · English
A Markdown to DOCX converter that follows GOST 7.32-2017 (the Russian standard for research and student
reports), plus a Telegram bot for study routine: send a .md and get a report ready to submit, send a
project .zip and get a .txt with the folder tree and file contents. The converter is installable on its
own as the md2gost package on PyPI. The bot speaks Russian.
Status: personal project, maintained · bot @my_convbot · package md2gost
Stack: Python 3.9+ · python-docx · aiogram 3 · Docker
md2gost — Markdown → DOCX per GOST
pip install md2gost
md2gost report.md # writes report.docx next to it
md2gost report.md -o out.docx --no-heading-numbers
What it does to the document:
- margins: left 30 mm, right 15, top and bottom 20; Times New Roman 14 pt, 1.5 line spacing, 1.25 cm first-line indent, justified text
- page numbers at the bottom center, none on the title page
- section numbering
1.,1.1.,1.1.1.; structural elements ("Введение", "Заключение", "Список литературы" and others) unnumbered, uppercase, centered - a page break before every second-level section
- bulleted lists with dashes and nesting, numbered lists as
1)with numbering restarted per list - tables with a "Таблица N" caption on the top left, code blocks and inline code in a monospace font,
quotes, footnotes
[^1], bold and italic
Command-line options: --font, --size, --spacing, --no-heading-numbers, --no-page-numbers,
--number-title-page. From Python:
from md2gost import DocumentSettings, MarkdownToDocxConverter
settings = DocumentSettings()
settings.auto_numbering_headings = True
MarkdownToDocxConverter(settings).convert("report.md", "report.docx")
The Markdown parser is custom and line-based: nested tables and lists inside tables are not supported.
The bot
| Send | Get |
|---|---|
.md |
a GOST-formatted .docx (the same md2gost, with heading numbers) |
project .zip |
a .txt: folder tree and contents of text files with line numbers, handy for an LLM or a report appendix |
Files up to 20 MB. Archives are checked before extraction: at most 5000 files and 200 MB unpacked. Service
folders (.git, node_modules, __pycache__, build…) and binary files are skipped. Conversion runs in
a separate thread, so the bot never freezes on big files.
git clone https://github.com/EDeev/converterbot.git && cd converterbot
cp .env.example .env # BOT_TOKEN from @BotFather
docker compose up -d
Prebuilt image: docker pull ghcr.io/edeev/converterbot or docker pull dcr.deev.su/edeev/converterbot.
Without Docker: pip install -r requirements.txt, then BOT_TOKEN=… python bot.py.
rep_to_txt.py also works on its own: python rep_to_txt.py path/to/project.
Development
pip install -r requirements-dev.txt
ruff check --select E9,F,B . && pytest
CI tests the package on Python 3.9, 3.12 and 3.13 and builds it. On v* tags the package is published to
PyPI and the bot's Docker image to GitHub Packages and dcr.deev.su.
License
MIT — see LICENSE.
Author
Egor Deev — GitHub · Telegram · egor@deev.space
Metadata
Release files for md2gost 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| md2gost-1.0.1.tar.gz | 14.8 kB | Without provenance | Details for md2gost-1.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| md2gost-1.0.1-py3-none-any.whl | Python 3 | none | any | Details for md2gost-1.0.1-py3-none-any.whl |
Total release size: 27.9 kB
Release files / md2gost-1.0.1.tar.gz
| Download URL | md2gost-1.0.1.tar.gz |
|---|---|
| Size | 14.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5258795d916d53efcdac61939a02221ec9ec042b7d64778cf3604355203987a1
|
|
BLAKE2b-256 checksum How to use checksums |
d84e8d7c029cfabdbbed5274f5a29928e28a17657a3b6b2cfa35ebb8daf58a09
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / md2gost-1.0.1-py3-none-any.whl
| Download URL | md2gost-1.0.1-py3-none-any.whl |
|---|---|
| Size | 13.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ed9c121e213e455698628025251c56d656d76da3bda3b3babb46d09c8d454f2e
|
|
BLAKE2b-256 checksum How to use checksums |
d81626faabcd7ffa01560b2d5b021d91fa5b5442f32c102c736576a8759ae4f6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for md2gost 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.