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

Incorporate global/page level configuration into the spec #52

Open chrisjsewell opened 1 year ago

chrisjsewell commented 1 year ago

Currently, there are numerous configuration formats/schemas for how MyST is parsed/rendered across implementations:

global:

page level:

For consistency across tools, it would be ideal to have a defined "core" JSON schema for such configuration, then potentially also a standard file name/format for global configuration (although this may not be possible for all implementations).

Particularly for page-level metadata, namespacing should definitely be considered, and also potentially defined way for extensions to add configuration.