Numbered cross references in MultiMarkdown are tricky

In MMD you can make a cross-reference using [][name of section] where name of section is a section title (or a reference name specified in brackets), but there’s no good way to refer to the section number.

For example, in a document with a section called “Preamble” you can type:

"Member" has the meaning ascribed in the [preable][Preamble].

But you can’t type:

"Member" has the meaning ascribed in Section [number??][Members].

The number is uwknown until the MMD document is processed into another format, and MMD doesn’t provide any shorthand for that number—only a way to refer to the section name.

A script might be able to add those references in—manually inserting numbers by counting up by section—but that script is an extra moving piece that would have to be developed.

Getting a reference to the section number in LaTeX, however, is easy. So the challenge is how to get an intuitive reference to the section number in MMD that LaTeX will properly recognize.

Ciaran Connelly @ciaran