Why is YAML synxtax preffered over Colon syntax for directive blocks?

mdformat-myst (0.3.0) auto corrects

```{admonition}
`:key: val`

to

```{admonition}
---
key: val
---

But why does it prefer the latter? It seems like the latest myst user documentation suggests the former is preferred here: https://myst-parser.readthedocs.io/en/latest/syntax/roles-and-directives.html#parameterizing-directives-options.

Thanks!

This issue looks like a duplicate of: #21

@kdeldycke

Thanks @kdeldycke, looks like there is a PR that was recently put in to address this too

Navigation Menu