Bug#687685: libpod-markdown-perl: Generating markdown pages from pod creates wrong link

[Florian Schlichting]

forwarded 687685 https://rt.cpan.org/Public/Bug/Display.html?id=57776
thanks

I didn't really understand your issue when first reading your bug
report, so I'll try to rephrase it:

You have an internal link in POD, like L</"DEBUG">. Using pod2markdown,
this results in markdown output like ["DEBUG"](#DEBUG). On github, this
doesn't actually create a working link to the section titled DEBUG, but
["DEBUG"](#debug) does, and so you're asking for pod2markdown to produce
that. Correct?

The problem with that request is that standard markdown does not have a
mechanism to define internal anchors that can be linked to, as opposed
to e.g. pandoc (see
http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html#header-identifiers-in-html-latex-and-context).
The patch in RT #57776 tries to add a similar mechanism to
Pod::Markdown, but not necessarily in a way that's compatible with
github flavored markdown.

Florian