Skip to content

Markdown support

Report Exporter reads the Markdown you already write in Obsidian. Nothing needs to change in your notes.

Markdown In the PDF
# Heading Level 1 heading in the template's main colour, listed in the table of contents
## to ###### Numbered automatically — A., 1., a) by default, configurable per level
**bold**, *italic*, ~~strike~~, `code` Inline formatting
[text](url) Link, clickable in the PDF for http(s) and mailto:
[[Page]], [[Page\|alias]] Flattened to readable text
- item, 1. item Lists
- [ ], - [x] Task lists, with vector check boxes
List under a # Recommendations heading Diamond bullets in the main colour (can be turned off)
> [!warning] Title Obsidian callout with the icon and colour of its type
> quote Quote box with an accent bar
| col | col | Styled table; a table too wide for the page is fitted to it
``` Code block
```mermaid Mermaid diagram, drawn by Obsidian's own Mermaid and embedded as vectors
```col, > [!col] Columns from the Obsidian Columns plugin, all three syntaxes
*Figure 1: …* Centred italic caption
text[^1] and [^1]: note, text^[inline note] Footnotes: a superscript number linked to the note, the notes gathered under Notes at the end of the report
%%comment%% Left out, as in Obsidian's reading view

Callout types: note, tip, info, todo, success, question, warning, failure, danger, bug, example, quote and their aliases.

Only paragraphs starting with Figure, Table, Chart, Diagram, Illustration, Appendix, Exhibit or Listing (or their French equivalents) become captions; an ordinary italic paragraph stays body text.

Images

![[capture.png]], ![[capture.png|400]] (width) and ![alt](path/capture.png) all work. PNG and JPEG are embedded as they are; WEBP, GIF, SVG, BMP, AVIF and TIFF are converted to PNG. A missing image is flagged in the report and in a notice instead of failing the export. An image repeated in the note is embedded only once, and an image reference written inside a code block is left alone.

Embedded notes

![[another note]] inlines that note's content, up to three levels deep; circular embeds are detected. A template can switch this to mention only. Notes marked with audience: or tlp: are left out of restricted versions — see Confidential export.

Page breaks

Put \pagebreak on its own line — or \newpage, [pagebreak], <!-- pagebreak -->, <div style="page-break-after: always"></div>. A template can also start every heading of a given level on a new page.

Limits

  • Fonts: Liberation Sans (metric-compatible with Arial), Liberation Mono and Archivo Black are embedded — which is why the plugin weighs about 5 MB. Scripts they do not cover (CJK, Arabic…) will not render.
  • Table of contents: entries are clickable but have no dot leaders.
  • Wide tables: columns get widths proportional to their content, the font shrinks down to 7 pt if needed, and as a last resort over-long words break between characters — no character is added, so a hash copied from the PDF stays exact.
  • Columns are not split across pages.
  • Dataview and other dynamic queries are not rendered. Page size is A4.