Problem with footnotes

peter2536's Avatar

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

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

    Fletcher's Avatar

    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

Reply to this discussion

Internal reply

Formatting help / Preview (switch to plain text) No formatting (switch to Markdown)

Attaching KB article:

»

Already uploaded files

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

Attached Files

You can attach files up to 10MB

If you don't have an account yet, we need to confirm you're human and not a machine trying to post spam.

Keyboard shortcuts

Generic

? Show this help
ESC Blurs the current field

Comment Form

r Focus the comment reply box
^ + ↩ Submit the comment

You can use Command ⌘ instead of Control ^ on Mac