Add attributes syntax

[chrisjsewell]

Relevant links:

• https://johnmacfarlane.net/beyond-markdown.html#attributes
• https://github.com/jgm/pandoc/issues/684
• https://www.npmjs.com/package/markdown-it-attrs
• For micromark, there is essentially already code for parsing them here: https://github.com/micromark/micromark-extension-directive/blob/main/dev/lib/factory-attributes.js

Attributes are a common Markdown syntax extension, e.g. {#id .class value=key}, which I think might be useful in MyST.

At a block-level, I think this would be relatively simple to implement in https://github.com/executablebooks/MyST-Parser, since they would essentially follow the same rules/logic as targets, e.g.

(target)=
# header

would be equivalent to

{#target}
# header

But then extra logic could also be added, to propagate classes as well as identifiers (for now we would ignore key/values), e.g.

{#target .class1 .class2}
# header

Would relate to HTML like

<h1 id="target" class="class1 class2">header</h1>

---

another place they could be added, is for defining role options, e.g. {name}`content`{#id .class key=value}

The problem here, though, is that docutils roles syntax does not support options. Although it is of note, that the role functions themselves, do actually accept an options key-word: https://github.com/live-clones/docutils/blob/48bb76093b4ba83654b2f2c86e7c52c4bb39c63b/docutils/docutils/parsers/rst/roles.py#L197-L211

[chrisjsewell]

One thing I'd note here, is that pandoc have their header attributes inline with the heading text, rather than above it:

# header {#target}

But actually this is contrary to the Markdown creator's proposal

Allow attributes to be added on the line before any block element and directly after any inline element

which I think makes a lot more sense

[rowanc1]

Another pointer to some users asking questions about this:

• https://github.com/orgs/executablebooks/discussions/816