[![Build Status][ci-badge]][ci-link]
[![codecov.io][codecov-badge]][codecov-link]
[![PyPI version][pypi-badge]][pypi-link]
# mdformat-myst
> Mdformat plugin for MyST compatibility
## Description
[Mdformat](https://github.com/executablebooks/mdformat) is a formatter for
[CommonMark](https://spec.commonmark.org/current/)
compliant Markdown.
Mdformat-myst is an mdformat plugin that changes the target specification to
[MyST](https://myst-parser.readthedocs.io/en/latest/using/syntax.html),
making the tool able to format the following syntax extensions:
- [tables](https://github.github.com/gfm/#tables-extension-)
- [directives](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#syntax-directives)
- [roles](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#syntax-roles)
- [inline and block "dollar math"](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#math-shortcuts)
- [comments](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#syntax-comments)
- [block breaks](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#syntax-blockbreaks)
- [targets](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#syntax-targets)
- [front matter](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#extended-block-tokens)
- [footnotes](https://pandoc.org/MANUAL.html#footnotes)
## Install
```sh
pip install mdformat-myst
```
## Usage
```sh
mdformat <filename>
```
[ci-badge]: https://github.com/executablebooks/mdformat-myst/workflows/Tests/badge.svg?branch=master
[ci-link]: https://github.com/executablebooks/mdformat-myst/actions?query=workflow%3ATest+branch%3Amaster+event%3Apush
[codecov-badge]: https://codecov.io/gh/executablebooks/mdformat-myst/branch/master/graph/badge.svg
[codecov-link]: https://codecov.io/gh/executablebooks/mdformat-myst
[pypi-badge]: https://img.shields.io/pypi/v/mdformat-myst.svg
[pypi-link]: https://pypi.org/project/mdformat-myst
Raw data
{
"_id": null,
"home_page": "https://github.com/hukkinj1/mdformat-myst",
"name": "mdformat_myst",
"maintainer": "Executable Book Project",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "executablebooks@gmail.com",
"keywords": "mdformat, markdown, formatter, gfm",
"author": "Taneli Hukkinen",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/01/6b/7066324956682e7a2046bd214ce8be2b668984a214b2ad16846b9ef23952/mdformat_myst-0.2.2.tar.gz",
"platform": null,
"description": "[![Build Status][ci-badge]][ci-link]\n[![codecov.io][codecov-badge]][codecov-link]\n[![PyPI version][pypi-badge]][pypi-link]\n\n# mdformat-myst\n\n> Mdformat plugin for MyST compatibility\n\n## Description\n\n[Mdformat](https://github.com/executablebooks/mdformat) is a formatter for\n[CommonMark](https://spec.commonmark.org/current/)\ncompliant Markdown.\n\nMdformat-myst is an mdformat plugin that changes the target specification to\n[MyST](https://myst-parser.readthedocs.io/en/latest/using/syntax.html),\nmaking the tool able to format the following syntax extensions:\n\n- [tables](https://github.github.com/gfm/#tables-extension-)\n- [directives](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#syntax-directives)\n- [roles](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#syntax-roles)\n- [inline and block \"dollar math\"](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#math-shortcuts)\n- [comments](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#syntax-comments)\n- [block breaks](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#syntax-blockbreaks)\n- [targets](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#syntax-targets)\n- [front matter](https://myst-parser.readthedocs.io/en/latest/using/syntax.html#extended-block-tokens)\n- [footnotes](https://pandoc.org/MANUAL.html#footnotes)\n\n## Install\n\n```sh\npip install mdformat-myst\n```\n\n## Usage\n\n```sh\nmdformat <filename>\n```\n\n[ci-badge]: https://github.com/executablebooks/mdformat-myst/workflows/Tests/badge.svg?branch=master\n[ci-link]: https://github.com/executablebooks/mdformat-myst/actions?query=workflow%3ATest+branch%3Amaster+event%3Apush\n[codecov-badge]: https://codecov.io/gh/executablebooks/mdformat-myst/branch/master/graph/badge.svg\n[codecov-link]: https://codecov.io/gh/executablebooks/mdformat-myst\n[pypi-badge]: https://img.shields.io/pypi/v/mdformat-myst.svg\n[pypi-link]: https://pypi.org/project/mdformat-myst\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Mdformat plugin for MyST compatibility.",
"version": "0.2.2",
"project_urls": {
"Homepage": "https://github.com/hukkinj1/mdformat-myst"
},
"split_keywords": [
"mdformat",
" markdown",
" formatter",
" gfm"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "7befe54faea14a3225193e05f4ca3da8ce4727ed9034b1113b0f33e372bbe50b",
"md5": "1c1f62208de1bded5baa449b6ffc6881",
"sha256": "c290caee7092dae864173042e2c5e89db429dbc0d1dc885d4750d7ed57ca966c"
},
"downloads": -1,
"filename": "mdformat_myst-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1c1f62208de1bded5baa449b6ffc6881",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 7082,
"upload_time": "2025-08-19T15:27:28",
"upload_time_iso_8601": "2025-08-19T15:27:28.026595Z",
"url": "https://files.pythonhosted.org/packages/7b/ef/e54faea14a3225193e05f4ca3da8ce4727ed9034b1113b0f33e372bbe50b/mdformat_myst-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "016b7066324956682e7a2046bd214ce8be2b668984a214b2ad16846b9ef23952",
"md5": "f810bfb07d82c1819f425763fd37d137",
"sha256": "9c09a9c3f4073ac7bb74159fab5d4c66fc8276e6638da05d5610ea81f803361e"
},
"downloads": -1,
"filename": "mdformat_myst-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "f810bfb07d82c1819f425763fd37d137",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 29993,
"upload_time": "2025-08-19T15:27:29",
"upload_time_iso_8601": "2025-08-19T15:27:29.591665Z",
"url": "https://files.pythonhosted.org/packages/01/6b/7066324956682e7a2046bd214ce8be2b668984a214b2ad16846b9ef23952/mdformat_myst-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-19 15:27:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hukkinj1",
"github_project": "mdformat-myst",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "mdformat_myst"
}
JSON
