MyST-Parser
MyST-Parser copied to clipboard
An extended commonmark compliant parser, with bridges to docutils/sphinx
Closes #407. The details are in the original bug report, but the long story short is that Docutils already adds a newline to its `` blocks, so we don't need...
### Describe the problem/need and solution I've been using MyST for a bit and it's quite nice being able to use Markdown instead of RST. However, a major pain point...
### Describe the bug I am using sphinx-build to build some markdown pages. I noticed some errors in the build yesterday that were referring to lines that don't exist in...
### Describe the bug **context** When somebody references a local document that has a space in the title, the reference does not properly resolve. So for example, `[my text](./path/to/my doc.md`...
### Describe the problem The result of `main.to_docutils` include an extra newline in each `literal_block` node. ### Link to your repository or website _No response_ ### Steps to reproduce Script:...
### Describe the bug **context** After upgrading MyST-Parser to the latest version, we're seeing these warnings while building our docs with Sphinx: ``` /home/runner/work/tango/tango/docs/source/CONTRIBUTING.md:154: WARNING: 'myst' reference target not found:...
### Describe the problem/need and solution **Context** "Markdown" means so many things, I am still not happy when I have to explain MyST and its differences to people, and why...
### Describe the bug **context** Broken link: [eval-rst directive](https://github.com/executablebooks/MyST-Parser/blob/74e91e6d81d7f28e27f6bb122c0fd6bf3a4bed88/docs/sphinx/syntax/directives/parsing). See text here -->[sphinx.ext.autodoc](https://github.com/executablebooks/MyST-Parser/blob/74e91e6d81d7f28e27f6bb122c0fd6bf3a4bed88/docs/sphinx/use.md#use-sphinxextautodoc-in-markdown-files) ### Reproduce the bug 1. go to [sphinx.ext.autodoc](https://github.com/executablebooks/MyST-Parser/blob/74e91e6d81d7f28e27f6bb122c0fd6bf3a4bed88/docs/sphinx/use.md#use-sphinxextautodoc-in-markdown-files) 2. click on [eval-rst directive](https://github.com/executablebooks/MyST-Parser/blob/74e91e6d81d7f28e27f6bb122c0fd6bf3a4bed88/docs/sphinx/syntax/directives/parsing). ### List your environment...
**Describe the solution you'd like** support mermaid **Describe alternatives you've considered** The conf.py I used to make work `mermaid` with `recommonmark`: ``` $ tail conf.py extensions = [ 'recommonmark', 'sphinxcontrib.mermaid']...
With RST you can use `rubric: footnotes` to make footnotes appear wherever you want. Is it possible to do this in MyST? It seems to only put them at the...