MGost converter

Converter from a markdown file to a ГОСТ document (.docx)

Documentation My projects Convert permissions Fast conversion

Specification sources

ФЗ «О науке и государственной научно-технической политике»

Федеральный закон №127 от 23 августа 1996 г. «О науке и государственной научно-технической политике».

Excerpt from a standard

Shorter version of standard that contains valuable info about creating this documents in Word. You can download it here.

Possibilities

Macros

Allows writing macros in markdown to save vars, change color text, name table and other utilities

Code execution

Some macroses allows running python code that will be inserted into output word document

Easy to start

MGost does not require any specific text, empty markdown document can be converted to word as well!

Projects: Web & Python

Create and edit projects either via the website or using the CLI Python library.

AI agents

AI agents can learn MGost from a single markdown document. Point your assistant to llms.md.

Quickstart

MGost CLI syncs a local folder with a project on this site and builds it on the server. You only need uv installed.

1. Get a token

Create an API token on the tokens page. The CLI asks for it on the first run, or reads it from the ARTICHAAPI_TOKEN environment variable or .mgost/.env.

2. Create a project

In the folder with your markdown file, create a new project or pick an existing one:

uvx -p 3.13 mgost@latest init

3. Build

Upload files and check the report, then build and download the .docx:

uvx -p 3.13 mgost@latest sync
uvx -p 3.13 mgost@latest render

The build log is printed to the console. Every command accepts --root/-r <folder> to work with a project outside the current folder.

Frequently Asked Questions

Find answers to common questions about MGost

MGost provides several advantages over Microsoft Word, them main of which are:

  1. Full automatic creation of styles according to ГОСТ (margins, font size, tabs, formulas)
  2. Automatic numbering of headers, images, formulas, tables, and appendix
  3. The ability to integrate with version control systems such as git

You can create and edit projects using the site or CLI Python library. Below are the instructions for using site editor.

  1. Create or log in to your account
  2. Create a project
  3. Perform a project render
    4. Location of render project button
  4. Download the rendered Word document
    5. Steps to download docx

There is 2 types of limitations:

  1. User trust — you can read more about this here
  2. Technical limitations:
    • • Splitting up tables
    • • The absence of heading "продолжение листинга #" in the appendix

There is MGost documentation and 4 examples of input and output md/docx files:

Название Markdown Документ Word
init init.md init.docx
diploma_short diploma_short.md diploma_short.docx
diploma diploma.md diploma.docx
diploma_headers diploma_headers.md diploma_headers.docx