CommonMark has yet to implement the popular MultiMarkdown v2+ feature, “Cross References.”
One of the things I’ve struggled with is creating unique
id's on elements, and incorporating them into Tables of Contents.
So, when I want to create a TOC, I have to use HTML. I’m not opposed to that, but it really doesn’t look as nice as Markdown.
Consider the following Markdown:
## Table of Contents * [This Is a Header] * [This Is a Subhead][subhead] # This Is a Header This is a paragraph. ## This Is a Subhead [subhead] This is another paragraph. This is a [link][This Is a Header] to the header. This is a [link][subhead] to the subhead, using an alternate reference link instead of \_the\_actual\_header\_title\_.
The resultant HTML would be:
<h2>Table of Contents</h2> <ul> <li><a href="#thisisaheader">This Is a Header</a></li> <li><a href="#subhead">This Is a Subhead</a></li> </ul> <h1>This Is a Header</h1> <p>This is a paragraph.</p> <h2 id="subhead">This Is a Subhead</h2> <p>This is another paragraph.</p> <p>This is a <a href="#thisisaheader">link</a> to the header.</p> <p>This is a <a href="#subhead">link</a> to the subhead, using an alternate reference link instead of _the_actual_header_title_.</p>
So instead of reverting to the HTML parlance of
<h1 id="..., you can just use slightly modified Markdown link syntax. You can see how MultiMarkdown makes it easy to link to headers in the document—without having to insert icky HTML into the source document.
Just something I’ve been thinking about suggesting for a while