Home → Problems (v2) →

Problem with footnotes

• Edit

peter2536

29 Apr, 2017 07:41 AM

Hi! I have just purchased a copy of MultiMarkdown (via the Mac App Store) and have found an issue with footnotes.

The "MultiMarkdown footnotes 1.jpeg" file shows both the editor and preview panes for a Markdown file with footnotes.

The footnote in the editor pane is shown as: Jäckel([^1]),
The footnote in the preview pane is shown as: Jäckel([1]),

The "MultiMarkdown footnotes 2.jpeg" file is a screen image of the same file/footnote as it appears in Marked2

The footnote is shown as: Jäckel(1), — this is the correct way to show a footnote reference.

Can I ask if it's possible for the MultiMarkdown apps' preview pane to show footnotes correctly?

Regards,
Peter

• MultiMarkdown_footnotes_1.jpeg 795 KB
• MultiMarkdown_footnotes_2.jpeg 517 KB

1. Support Staff 1 Posted by Fletcher on 29 Apr, 2017 04:32 PM

   

   Peter,

   Thanks for your purchase and thanks for writing in!

   First, a few definitions so we're all on the same page.

   1) You purchased MultiMarkdown Composer, which is a text editor.

   2) MultiMarkdown is a free/open source project that converts text into
   HTML and other formats. The newest version is v6 (as of the last month
   or two), but the most commonly used version is probably still v5.

   3) MMD Composer is effectively a wrapper around MultiMarkdown itself.

   Your question is actually about MMD, not Composer.

   There is no single correct approach, it's a question of which style
   rules you are trying to follow. For example, if anything, the proper
   format for a footnote (not a citation) is to use a superscript (at least
   in English).

   Historically, MMD has used `[1]` as the marker for footnotes for
   visibility, since citations were handled as a variant of the footnote
   syntax. Therefore `[^footnote]` and `[#citation]` would have similar
   appearance in the text. And since glossary terms were simply special
   footnotes, they share the same appearance as well.

   This is all the correct behavior for MultiMarkdown (v5 and earlier), and
   therefore is correct for MultiMarkdown Composer.

   MultiMarkdown version 6, however, has more of a distinction between
   footnotes, citations, glossary terms, and abbreviations.

   <https://github.com/fletcher/MultiMarkdown-6>

   For the moment, MMD v6 shares a similar output format as MMD 5 and
   earlier for the sake of consistency, but I am considering changing this.
     Footnotes would use superscripts. Citations could then use
   parentheses. Glossary terms and abbreviations already use a different
   format and would not change from their current structure.

   MMD 6 will be the standard on which MultiMarkdown Composer v 3 is based
   (the App Store currently sells version 2).

   That's the complete answer to your question.

   The short answer is:

   1. MMD v6 will probably match what you want, provided you mean citations
   when you say footnotes.

   2. MMD Composer v3 beta is available now, but is still built on MMD v5.
   I am working on the next generation of Composer which is built on MMD
   v6, so it will incorporate these changes.

   3. If proper formatting is really important, then consider using MMD ->
   LaTeX if you're producing papers. The output is much better, and you
   can configure the markup however you like. If you're producing web
   pages, then that would not help you.

   Hope this helps,

   Fletcher

   • Edit

2. Fletcher closed this discussion on 31 Aug, 2017 01:14 AM.