Links to .md should translate to .html

[fidian]

Let's say I have an index.md file and I want to point it to my FAQ page:

Go see my [FAQ](faq.md).

The problem is that this link is broken in the preview, but it can work just fine if you have a markdown-enabled browser of some sort.

I would like for the markdown version of my files to link to other markdown files and the HTML versions to link to HTML. Would you add the feature so the file extension is checked against what content plugins would parse and use the resulting file extension from after parsing?

[dashed]

Do you use an application that resolves url links targeting *.md files?

[fidian]

Yes, I use it for documentation on projects at work. It serves up the markdown as HTML, but since the URL contains "path/to/file.md", the *.md links work fine.

[jnordberg]

As of 2.0 you can write a generator plugin that adds the md files to the tree.

[fidian]

Can you explain what this means to me? I'm looking to write links with [some link](page.md) and have it translated into HTML as <a href="page.html">some link</a>. Your description of a generator plugin adding md files to the tree sounds like links to .md files would work, which is the flip side of what I was seeking.

Is there documentation on this somewhere?

[fidian]

Updated my above comment to escape the markdown and HTML examples. Unless your changes address this problem, I wouldn't consider this issue resolved. Can this issue be reopened? I can't do it. My only options are to create a new issue or have someone else reopen this one.

[jnordberg]

To get the url resolving you are looking for you would have to write a plugin that handles markdown and hook in to the markdown parser to get the urls so you can rewrite them. You can subclass the default markdown page plugin, it's exposed as env.plugins.MarkdownPage also check src/plugins/markdown.cofffe and src/plugins/page.cofffe

[fidian]

Thanks for pointing me in the right direction.