fletcher / peg-multimarkdown

An implementation of MultiMarkdown in C, using a PEG grammar - a fork of jgm's peg-markdown. No longer under active development - see MMD 5.
Other
523 stars 55 forks source link

More flexible cross-reference linking #99

Closed commonsguy closed 12 years ago

commonsguy commented 12 years ago

This allows you to use [MultiMarkdownOverview] to refer to this section specifically, and not another section named Overview.

It would be nice if MMD could allow [some prose here](MultiMarkdownOverview) to refer to this section specifically, so that we can have more pleasant links. Or, allow [some prose here](#MultiMarkdownOverview) to refer to this section specifically, if you need to distinguish this case from a normal WikiWord. Right now, the only way to use cross-references that I see is to have the WikiWord appear in the prose, which is unsuitable in some circumstances.

fletcher commented 12 years ago

Not sure I follow. MMD has no concept of WikiWords (it used to years ago in older perl versions) bug peg-multimarkdown never did.

Any of the following already work:

Link to [MultiMarkdownOverview], or [this][MultiMarkdownOverview], or [this](#multimarkdownoverview).
commonsguy commented 12 years ago

I can confirm that the second syntax works -- haven't tried the third. Note that only the first appears to be documented in the user's guide. Thanks!

fletcher commented 12 years ago

It's given as an example. You can use any valid link syntax.

commonsguy commented 12 years ago

It is not given as an example in section 4.4 of http://fletcher.github.com/peg-multimarkdown/mmd-manual.pdf . The only examples are [Some Text][], [Metadata][], and [MultiMarkdownOverview], none of which demonstrate the second and third syntax flavors shown above.