search

jupyter-book / myst-spec

MyST is designed to create publication-quality, computational documents written entirely in Markdown.
https://mystmd.org/spec
MIT License
14 stars 6 forks source link

Directives should be declarative #7

Open rowanc1 opened 2 years ago

rowanc1 commented 2 years ago

Arguments are always arguments.

The parser should be able to read directives, and that should never be bumped down to the body.

Don't care what the directive is, can always know that the options are the options.

chrisjsewell commented 2 years ago

I'm not sure why this got closed? Still definitely desirable (particularly for https://github.com/executablebooks/unified-myst)

It would require a "deprecation" in https://github.com/executablebooks/MyST-Parser, which should be possible, to add a warning prompting people to change any existing directives that are not compliant