MyST-Parser
sphinx-diagrams
Our great sponsors
MyST-Parser | sphinx-diagrams | |
---|---|---|
4 | 1 | |
685 | 18 | |
2.2% | - | |
7.0 | 1.8 | |
7 days ago | over 2 years ago | |
Python | Python | |
MIT License | BSD 2-clause "Simplified" License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
MyST-Parser
- Minimum Viable Hugo – No CSS, no JavaScript, 1 static HTML page to start you off
-
Python toolkits
Sphinx along with MyST-parser to write documentation in markdown. I recently discovered portray which seems like a nice alternative as it supports markdown by default for both generic documentation and docstring in modules, class, methods and functions.
-
On Yak Shaving and, a New HTML Element for Markdown
https://github.com/executablebooks/myst-parser :
> 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.
https://markdown-it-py.readthedocs.io/en/latest/ :
> *Follows the CommonMark spec for baseline parsing;
-
A step towards educating with Spyder
This project is just the first step towards making Spyder an educational tool. In the future, we hope that we can develop the infrastructure necessary to support in-IDE tutorials, by improving the tools like Jupyter Book, sphinx-thebe, MyST-Parser which will provide better integration to write educational tutorials.
sphinx-diagrams
What are some alternatives?
Python-Markdown - A Python implementation of John Gruber’s Markdown with Extension support.
mermaid - Generation of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown
jupyter-book - Create beautiful, publication-quality books and documents from computational content.
Read the Docs - The source code that powers readthedocs.org
sphinxcontrib-mermaid - Mermaid diagrams in yours sphinx powered docs
drawio_mermaid_plugin - Mermaid plugin for drawio desktop
sphinx-thebe - A Sphinx extension to convert static code into interactive code cells with Jupyter, Thebe, and Binder.
sphinx-revealjs - HTML Presentation builder for Pythonista
sphinx-vhdl
diagrams - :art: Diagram as Code for prototyping cloud system architectures
sphinx - The Sphinx documentation generator
sphinx-readme - Generate Beautiful reStructuredText README.rst for GitHub, PyPi, GitLab, BitBucket