Creating figures with a caption depending on context (no markup natural convention)

[nhoizey]

Another option would be to use a caption attribute if this other extension is accepted some day:

Consistent attribute syntax

Eventually, the spec should specify a consistent way to add attributes to at least the following elements: headers, images, code blocks (and maybe even tables, block quotes and inline code and quotes). The most important attributes are certainly id (to enable links to those elements) and class (for styling) which might have shortcuts like #myId and .myClass but other attributes (like width and height for images) are useful as well. Stmd currently specifies info strings for code blocks. I think …