Skip to content

Home

Jump to bottom
Christophe Demko edited this page Dec 14, 2017 · 11 revisions

Explanation

In the metadata block, specific set of classes can be defined to decorate div or codeblock elements by admonition generated from the mdframed LaTeX package

The metadata block add information using the pandoc-latex-admonition entry by a list of definitions:

pandoc-latex-admonition:
# order is important
  - color: firebrick
    classes: [admonition, danger]
  - color: gray
    classes: [admonition]

The metadata block above is used to add a red admonition to divs or codeblocks which have admonition and danger classes and a gray admonition to divs or codeblocks that have only a admonition class.

Each entry of pandoc-latex-admonition is a YAML dictionary containing:

  • classes: the set of classes of the divs to which the transformation will be applied. This parameter is mandatory.
  • color: the color name taken from the X11 color collection.
  • position: the position of the admonition (left by default or right)
  • liwewidth the line width (2 by default)
  • margin the margin from the text (-4 by default. See https://www.ctan.org/pkg/mdframed)
  • innermargin the innermargin from the text (5 by default. See https://www.ctan.org/pkg/mdframed)
  • localfootnotes use local footnotes inside the admonition (false by default)

It's also possible to set an admonition on a specific div or codeblock element using these attributes:

For correct LaTeX output, figures (an image with nonempty alt text, occurring by itself in a paragraph) must be shifted after the div.

The following LaTeX packages are required:

  • mdframed

Example

Demonstration: Using pandoc-latex-admonition-sample.txt as input gives output file in pdf. You must have the Markdown-mark.svg.png image for correct testing.

Clone this wiki locally