MyST-Parser

MyST-Parser copied to clipboard

Translate non-default directives (breathe extension)

4

**Is your feature request related to a problem? Please describe.** I cannot combine MyST with other non-default Sphinx extensions, like breathe. In RST, I would write:: `.. doxygenstruct:: MyStruct` (https://breathe.readthedocs.io/en/latest/struct.html)...

arwedus

MyST crashes without error message (breathe extension)

6

**Describe the bug** MyST crashes without error message if "directive_class" is not a class. **To Reproduce** Cannot reproduce, because the error message does not mention the problematic file and the...

arwedus

Documentation: Mermaid example broken

1

### Describe the problem The example given for using mermaid is broken.  ### Link to your repository or website https://myst-parser.readthedocs.io/en/latest/sphinx/intro.html?highlight=note%20box#install-a-new-sphinx-extension-and-use-its-functionality ### Steps to reproduce 1. Go to this link...

jrwrigh

Document how to indent nest directives

8

### Description / Summary I recently came across this (resolved) Sphinx issue: sphinx-doc/sphinx#9165. It was (no need to read or re-read that now) about the [tutorial] aimed at beginners. The...

john-hen

Configure external link recognition (and handling)

12

Currently, if a link (`[text](link)`) does not match a URL scheme (e.g. 'http://...') then it is treated as an internal cross-reference (to a reference target or sphinx document, etc): https://github.com/executablebooks/MyST-Parser/blob/3d5ae4f94c9d39435d76861b86dc5171ee23c9df/myst_parser/docutils_renderer.py#L412-L415...

chrisjsewell

Add initial Towncrier integration

5

Preview: https://myst-parser--469.org.readthedocs.build/en/469/develop/_changelog.html#changelog. Resolves #454

webknjaz

Wrap reference with span.problematic, when the reference is broken

3

### Describe the problem MyST does not add the `problematic` class on references that were not resolved successfully. ### Link to your repository or website _No response_ ### Steps to...

pradyunsg

Fix smartquote logic

2

I'm surprised no one has noticed this before, but I've just realised there are some "conflicts" in how smartquotes are handled; between myst (via markdown-it), docutils and sphinx. --- Within...

chrisjsewell

✨ NEW: Add `toclist` extension

12

By adding `"toclist"` to `myst_enable_extensions` (in the sphinx `conf.py` [configuration file](https://www.sphinx-doc.org/en/master/usage/configuration.html)), you will be able to specify [sphinx `toctree`](https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-toctree) in a Markdown native manner. `toclist` are identified by bullet lists...

chrisjsewell

TOC directive as extension for table of contents

2

### Description / Summary Doxygen provides a nice syntax for including a table of contents to a markdown document: Simply add `[TOC]` as a placeholder. The table of contents will...

arwedus