# MyST-Parser
[![Github-CI][github-ci]][github-link]
[![Coverage Status][codecov-badge]][codecov-link]
[![Documentation Status][rtd-badge]][rtd-link]
[![Code style: black][black-badge]][black-link]
[![PyPI][pypi-badge]][pypi-link]
[![Conda][conda-badge]][conda-link]
[![PyPI - Downloads][install-badge]][install-link]
**MyST is a rich and extensible flavor of Markdown meant for technical documentation and publishing**.
MyST is a flavor of markdown that is designed for simplicity, flexibility, and extensibility.
This repository serves as the reference implementation of MyST Markdown, as well as a collection of tools to support working with MyST in Python and Sphinx.
It contains an extended [CommonMark](https://commonmark.org)-compliant parser using [`markdown-it-py`](https://markdown-it-py.readthedocs.io/), as well as a [Sphinx](https://www.sphinx-doc.org) extension that allows you to write MyST Markdown in Sphinx.
[**See the MyST Parser documentation for more information**](https://myst-parser.readthedocs.io/en/latest/).
## Installation
To install the MyST parser, run the following in a
[Conda environment](https://docs.conda.io) (recommended):
```bash
conda install -c conda-forge myst-parser
```
or
```bash
pip install myst-parser
```
Or for package development:
```bash
git clone https://github.com/executablebooks/MyST-Parser
cd MyST-Parser
git checkout master
pip install -e .[code_style,linkify,testing,rtd]
```
To use the MyST parser in Sphinx, simply add: `extensions = ["myst_parser"]` to your `conf.py`.
## Contributing
We welcome all contributions!
See the [Contributing Guide](https://myst-parser.readthedocs.io/en/latest/develop/index.html) for more details.
[github-ci]: https://github.com/executablebooks/MyST-Parser/workflows/continuous-integration/badge.svg?branch=master
[github-link]: https://github.com/executablebooks/MyST-Parser
[codecov-badge]: https://codecov.io/gh/executablebooks/MyST-Parser/branch/master/graph/badge.svg
[codecov-link]: https://codecov.io/gh/executablebooks/MyST-Parser
[rtd-badge]: https://readthedocs.org/projects/myst-parser/badge/?version=latest
[rtd-link]: https://myst-parser.readthedocs.io/en/latest/?badge=latest
[black-badge]: https://img.shields.io/badge/code%20style-black-000000.svg
[pypi-badge]: https://img.shields.io/pypi/v/myst-parser.svg
[pypi-link]: https://pypi.org/project/myst-parser
[conda-badge]: https://anaconda.org/conda-forge/myst-parser/badges/version.svg
[conda-link]: https://anaconda.org/conda-forge/myst-parser
[black-link]: https://github.com/ambv/black
[install-badge]: https://img.shields.io/pypi/dw/myst-parser?label=pypi%20installs
[install-link]: https://pypistats.org/packages/myst-parser
Raw data
{
"_id": null,
"home_page": null,
"name": "myst-parser",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "markdown, lexer, parser, development, docutils, sphinx",
"author": null,
"author_email": "Chris Sewell <chrisj_sewell@hotmail.com>",
"download_url": "https://files.pythonhosted.org/packages/85/55/6d1741a1780e5e65038b74bce6689da15f620261c490c3511eb4c12bac4b/myst_parser-4.0.0.tar.gz",
"platform": null,
"description": "# MyST-Parser\n\n[![Github-CI][github-ci]][github-link]\n[![Coverage Status][codecov-badge]][codecov-link]\n[![Documentation Status][rtd-badge]][rtd-link]\n[![Code style: black][black-badge]][black-link]\n[![PyPI][pypi-badge]][pypi-link]\n[![Conda][conda-badge]][conda-link]\n[![PyPI - Downloads][install-badge]][install-link]\n\n\n**MyST is a rich and extensible flavor of Markdown meant for technical documentation and publishing**.\n\nMyST is a flavor of markdown that is designed for simplicity, flexibility, and extensibility.\nThis repository serves as the reference implementation of MyST Markdown, as well as a collection of tools to support working with MyST in Python and Sphinx.\nIt contains an extended [CommonMark](https://commonmark.org)-compliant parser using [`markdown-it-py`](https://markdown-it-py.readthedocs.io/), as well as a [Sphinx](https://www.sphinx-doc.org) extension that allows you to write MyST Markdown in Sphinx.\n\n[**See the MyST Parser documentation for more information**](https://myst-parser.readthedocs.io/en/latest/).\n\n## Installation\n\nTo install the MyST parser, run the following in a\n[Conda environment](https://docs.conda.io) (recommended):\n\n```bash\nconda install -c conda-forge myst-parser\n```\n\nor\n\n```bash\npip install myst-parser\n```\n\nOr for package development:\n\n```bash\ngit clone https://github.com/executablebooks/MyST-Parser\ncd MyST-Parser\ngit checkout master\npip install -e .[code_style,linkify,testing,rtd]\n```\n\nTo use the MyST parser in Sphinx, simply add: `extensions = [\"myst_parser\"]` to your `conf.py`.\n\n## Contributing\n\nWe welcome all contributions!\nSee the [Contributing Guide](https://myst-parser.readthedocs.io/en/latest/develop/index.html) for more details.\n\n[github-ci]: https://github.com/executablebooks/MyST-Parser/workflows/continuous-integration/badge.svg?branch=master\n[github-link]: https://github.com/executablebooks/MyST-Parser\n[codecov-badge]: https://codecov.io/gh/executablebooks/MyST-Parser/branch/master/graph/badge.svg\n[codecov-link]: https://codecov.io/gh/executablebooks/MyST-Parser\n[rtd-badge]: https://readthedocs.org/projects/myst-parser/badge/?version=latest\n[rtd-link]: https://myst-parser.readthedocs.io/en/latest/?badge=latest\n[black-badge]: https://img.shields.io/badge/code%20style-black-000000.svg\n[pypi-badge]: https://img.shields.io/pypi/v/myst-parser.svg\n[pypi-link]: https://pypi.org/project/myst-parser\n[conda-badge]: https://anaconda.org/conda-forge/myst-parser/badges/version.svg\n[conda-link]: https://anaconda.org/conda-forge/myst-parser\n[black-link]: https://github.com/ambv/black\n[install-badge]: https://img.shields.io/pypi/dw/myst-parser?label=pypi%20installs\n[install-link]: https://pypistats.org/packages/myst-parser\n",
"bugtrack_url": null,
"license": null,
"summary": "An extended [CommonMark](https://spec.commonmark.org/) compliant parser,",
"version": "4.0.0",
"project_urls": {
"Documentation": "https://myst-parser.readthedocs.io",
"Homepage": "https://github.com/executablebooks/MyST-Parser"
},
"split_keywords": [
"markdown",
" lexer",
" parser",
" development",
" docutils",
" sphinx"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cab4b036f8fdb667587bb37df29dc6644681dd78b7a2a6321a34684b79412b28",
"md5": "25125e0d61eaff86d2a0dda105c03ff0",
"sha256": "b9317997552424448c6096c2558872fdb6f81d3ecb3a40ce84a7518798f3f28d"
},
"downloads": -1,
"filename": "myst_parser-4.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "25125e0d61eaff86d2a0dda105c03ff0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 84563,
"upload_time": "2024-08-05T14:02:43",
"upload_time_iso_8601": "2024-08-05T14:02:43.767672Z",
"url": "https://files.pythonhosted.org/packages/ca/b4/b036f8fdb667587bb37df29dc6644681dd78b7a2a6321a34684b79412b28/myst_parser-4.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "85556d1741a1780e5e65038b74bce6689da15f620261c490c3511eb4c12bac4b",
"md5": "e702667009f8e1d054d0de2718276384",
"sha256": "851c9dfb44e36e56d15d05e72f02b80da21a9e0d07cba96baf5e2d476bb91531"
},
"downloads": -1,
"filename": "myst_parser-4.0.0.tar.gz",
"has_sig": false,
"md5_digest": "e702667009f8e1d054d0de2718276384",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 93858,
"upload_time": "2024-08-05T14:02:45",
"upload_time_iso_8601": "2024-08-05T14:02:45.798117Z",
"url": "https://files.pythonhosted.org/packages/85/55/6d1741a1780e5e65038b74bce6689da15f620261c490c3511eb4c12bac4b/myst_parser-4.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-05 14:02:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "executablebooks",
"github_project": "MyST-Parser",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "myst-parser"
}
JSON
