Automatically generated link text

A common feature of structured authoring systems is the ability to insert a crossreference to another section without also providing link text. For example you might add the markup <xref linkend=“some-sections-id”/>, knowing that elsewhere in the doc there’s a <section id=“some-sections-id”><title>All about widgets… The processing system would then turn the xref into a hyperlink with the text taken from the title as the link text.

In middleman+markdown, it appears that every time you link to another markdown file, you must provide some link text, usually the title of the target page. These links become a maintenance headache when you change the title of the page and must find and replace all the links to that page.

Does some mechanism or extension exist already that handles this in the context of middleman and markdown? Perhaps links in the format [@target@](../foobarbaz) could be processed such that the target text is pulled from the frontmatter of …/foobarbaz.html.markdown.

Regards,
David

1 Like