MyST Enhancement Proposals#

A formal process for changing the MyST Markdown Specification and an archive of present and past proposals.

Because the MyST specification has many interior and exterior stakeholders, we use a more formal and structured process around changing the specification[1]. These are called MyST Enhancement Proposals (MEPs).

This process is encoded in executablebooks/myst-enhancement-proposals and in this documentation. The sections below describe the process, and the MEP index is where you can find all of our MEPs.

Work in progress!

This process is relatively new. Bear with us, and please provide feedback if you think the process can be improved!

MyST Specification#

The MyST specification is at spec.mystmd.org (repository: executablebooks/myst-spec). It is the source of truth for MyST Markdown syntax.

When a MEP is accepted, it is generally implemented by modifying the specification and the documentation around it. MyST parsers may then choose to implement these changes on their own.

List of MEPs#

Below is a list of all past and current MEPs, you can also find this table at List of MEPs.

#

title

created

status

discussion

0001

MyST Enhancement Proposal Bootstrap Process

2022-10-16

Accepted

link

0002

Cross Reference Simplifications using Markdown Links

2023-03-03

Accepted

link