Could you put {{TOC}} in Metadata?

Kolen's Avatar


14 Mar, 2015 06:07 AM

Hi, I found that in the latest version of MMD, {{TOC}} is added. It is a very nice feature. But currently very cumbersome to be included to support both HTML and LaTeX. (I mean it is support LaTeX already but I want the native ToC from LaTeX.)

One way I do it currently is:

**Table of Contents**


Such that the HTML will skip the LaTeX command and the LaTeX will skip the TOC generated by mmd.

What I want to suggest is to promote it to a metadata field. (I am not sure if it can be done already since the documentation didn't mention.), implemented in a similar way as the base header level such that it has variants. In this way I can activate TOC in HTML only, and use LaTeX Input to include the \tableofcontents. It is also useful in file transclusion since the transcluded file ignores the metadata, and hence I won't have repeated metadata in the result.

Another suggestion is to replace {{TOC}} automatically with \tableofcontents when converting into LaTeX. And possibly define {{TOC}}[5] to mean\setcounter{tocdepth}{5} \tableofcontents` which can also be used for HTML output.

  1. Support Staff 1 Posted by fletcher on 14 Mar, 2015 01:13 PM

    fletcher's Avatar

    Between existing features, there is already the ability to do this -- you can use file transclusion to specify {{TOC}} only in certain formats, or the approach that you used above.

    In general, I don't want to make MMD any more complex than it already is, but rather make use of the current features to implement customizations.

  2. fletcher closed this discussion on 14 Mar, 2015 01:13 PM.

  3. Kolen re-opened this discussion on 14 Mar, 2015 10:39 PM

  4. 2 Posted by Kolen on 14 Mar, 2015 10:39 PM

    Kolen's Avatar

    Thanks. The file transclusion feature is a nice suggestion.

    However, it doesn't quite work for me. It will turn my .tex file having \ into \textbackslash

    Another problem is I don't understand why when I use .*, transclusion to .tex works fine, but not .html. Another related question is I don't know what to put in the .html.


    **Table of Contents**

    But I'm not sure if it will treat it like mmd code or html code...

    In general, I find the file transclusion feature intriguing. But the documentation on this is very limited and vague. I think it would be better if, say, it has some example in the mmd gallery.

  5. Support Staff 3 Posted by fletcher on 16 Mar, 2015 01:15 PM

    fletcher's Avatar

    File transclusion is very simple -- it replaces {{foo}} with the
    contents of the file to create a single MMD document. That's it.

    Everything is still treated as MultiMarkdown, it's just divided amongst
    multiple files.


  6. Kolen closed this discussion on 02 Mar, 2016 02:51 AM.

Comments are currently closed for this discussion. You can start a new one.

Keyboard shortcuts


? 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

Recent Discussions

11 Dec, 2022 09:57 PM
11 Dec, 2022 07:57 PM
26 Sep, 2022 02:40 AM
21 Jul, 2022 10:22 AM
11 Jan, 2022 02:33 PM

Recent Articles