How do I make a link to a section of a document in the same directory(pandoc markdown->html output)

Question

I have two fairly simple pieces of documentation(written in markdown that is used to generate html files with pandoc). I'd like to be able to link to a section of the second document from the first document.

Preference order for solutions:

• Using General Markdown Features
• Using Pandoc Extensions Using
• embedded HTML

Answer 1

Pandoc has a "Header identifiers in HTML"-extension for this usecase. In the documentation is an example, how to provide links from one section of a document to another.