I'm trying to use Org mode's export to markdown, and am finding some unexpected results.
For a file:
* Section
This is some test.[fn:1]
@@markdown:This should appear in markdown export.@@
* Footnotes
[fn:1] This is a footnote.
The export backend produces:
# Table of Contents
1. [Section](#org26628a6)
<a id="org26628a6"></a>
# Section
This is some test.<sup><a id="fnr.1" class="footref" href="#fn.1">1</a></sup>
# Footnotes
<sup><a id="fn.1" href="#fnr.1">1</a></sup> This is a footnote.
Which looks very much like a mixture of markdown with html markup. Plus @@markdown: ...@@
does not seem to work.
What am I missing? Any ideas of how I could get better results?
Update: Says the Org mode manual:
The
md
back-end is built over HTML back-end: any construct not supported by Markdown syntax (e.g., tables) will be controlled and translated by ‘html’ back-end.
So that's probably the explanation to the result, as neither ToC nor footnotes seem to be supported by vanilla markdown.