# 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.8",
"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/49/64/e2f13dac02f599980798c01156393b781aec983b52a6e4057ee58f07c43a/myst_parser-3.0.1.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": "3.0.1",
"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": "e2de21aa8394f16add8f7427f0a1326ccd2b3a2a8a3245c9252bc5ac034c6155",
"md5": "43f0244b7785ccc007ce5235a0fee181",
"sha256": "6457aaa33a5d474aca678b8ead9b3dc298e89c68e67012e73146ea6fd54babf1"
},
"downloads": -1,
"filename": "myst_parser-3.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "43f0244b7785ccc007ce5235a0fee181",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 83163,
"upload_time": "2024-04-28T20:22:39",
"upload_time_iso_8601": "2024-04-28T20:22:39.985295Z",
"url": "https://files.pythonhosted.org/packages/e2/de/21aa8394f16add8f7427f0a1326ccd2b3a2a8a3245c9252bc5ac034c6155/myst_parser-3.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4964e2f13dac02f599980798c01156393b781aec983b52a6e4057ee58f07c43a",
"md5": "d0b64b1195019993e14bcb2f06d68b5f",
"sha256": "88f0cb406cb363b077d176b51c476f62d60604d68a8dcdf4832e080441301a87"
},
"downloads": -1,
"filename": "myst_parser-3.0.1.tar.gz",
"has_sig": false,
"md5_digest": "d0b64b1195019993e14bcb2f06d68b5f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 92392,
"upload_time": "2024-04-28T20:22:42",
"upload_time_iso_8601": "2024-04-28T20:22:42.116552Z",
"url": "https://files.pythonhosted.org/packages/49/64/e2f13dac02f599980798c01156393b781aec983b52a6e4057ee58f07c43a/myst_parser-3.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-28 20:22:42",
"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"
}