Markdown Code Guidelines

Formatters and Linters

When writing Markdown Language, please

  • Lint your code with markdownlint.

    To lint a file run mdl path/to/ in a terminal. The settings to use are specified in .mdlrc, which is automatically read by markdownlint.

    markdownlint can e.g. be installed as a snap package (unofficial) or as a RubyGems package.


The listed formatters and linters offer plugins for many popular text editors and integrated development environments (IDEs). When using these plugins, your code is formatted and linted on the fly, so you don’t have to run the commands yourself.


If you have set up pre-commit, the above formatters and linters check your code before every commit.