MyST-Parser
Note: myst-docutils is identical to myst-parser, but without installation requirements on sphinx
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-compliant parser using markdown-it-py, as well as a Sphinx extension that allows you to write MyST Markdown in Sphinx.
See the MyST Parser documentation for more information.
Installation
To install the MyST parser, run the following in a Conda environment (recommended):
conda install -c conda-forge myst-docutils
or
pip install myst-docutils
Or for package development:
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 for more details.
Metadata
Release files for myst-docutils 4.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| myst_docutils-4.0.0.tar.gz | 94.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| myst_docutils-4.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 178.6 kB
Release files / myst_docutils-4.0.0.tar.gz
| Download URL | myst_docutils-4.0.0.tar.gz |
|---|---|
| Size | 94.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4ee272c43c4f9275fa6b5dda12edb806da0b6ff20e8e5b88fb3201b6d81e598f
|
|
BLAKE2b-256 checksum How to use checksums |
7dfa460c6be63bd0a9e334256827f0b97e08616de3da160ffe266b1afcf6bebe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.32.3
|
Release files / myst_docutils-4.0.0-py3-none-any.whl
| Download URL | myst_docutils-4.0.0-py3-none-any.whl |
|---|---|
| Size | 84.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
895c4bb882d43a0652abb5d64082b0e14ee3155bb8ad2ee21ffc5773ecfded50
|
|
BLAKE2b-256 checksum How to use checksums |
b21eae02fb8d8c1e0a49b33c0d646b3661db0c266cbbfab27f61f92f804710b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.32.3
|