MyST-Parser

MyST-Parser copied to clipboard

[release automation] Changelog fragments management

3

### Description / Summary I noticed that currently `CHANGELOG.md` is being managed manually. I have recently figured out how to configure Towncrier to work with Markdown so I wanted to...

webknjaz

I am using `breathe` to parse `Doxygen XML output` and dump them in a markdown file using `myST`. An issue is facing that, Parent class formerly shows a cross-reference link...

atifkarim

Make target reference work for arbitrary locations

6

### Description / Summary In plain reStructuredText, [labels](https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#ref-role) can be placed in arbitrary locations and be referenced by the `:ref:` role. In MyST markdown, I get a warning for `figure_label`in...

arwedus

Footnotes translation

5

### Describe the problem The expected behaviour of footnotes with text before and after when they are translated is wrong (without text, everything seems to be ok). The reference to...

ValentinConstantin

include directive: start from alternative heading level

7

Thanks for the great project. I perfectly fits the use case I have, with one minor issue. **TL;DR**: Is it possible to fix or ignore non-consecutive header levels? For a...

comabrewer

Document Napoleon integration

5

Hi, in the MyST FAQ I saw something about autodoc integration. Maybe you could also write about Napoleon integration: https://sphinxcontrib-https://sphinxcontrib-napoleon.readthedocs.io/en/latest/#.readthedocs.io/en/latest/# I am asking because many ppl. use this kind of...

PhilipMay

Wikilinks `[[ ]]` syntax for cross-references

2

### Describe the enhancement you'd like In the wiki world, it is common to use wikilinks (like `[[mylink]]`) for references within and between pages. This is quite similar semantically to...

choldgraf

How to refer to a static resource?

11

Hello, I'm currently moving the last bits of our [docs from RST to md using MyST](https://github.com/dib-lab/sourmash/pull/1021) but I couldn't figure out how to link to files in the `_static/` dir....

luizirber

file:///// links skipped in HTML output of Sphinx

3

### Describe the problem The behaviour of an inline link to an external resource (access through file://///) does not work as expected for an .md input to MyST when generating...

Mershl

Incorrect "line 1, column 1" in an "Invalid options YAML: while parsing a block mapping" error

2

This is an informational maybe-bug, I was not able to reproduce it. One of my novice contributors ran into it but resolved it on their own. Perhaps this report will...

feorlen