Skip to content

Features Overview

MergDown2TeX converts Obsidian notes to publication-ready LaTeX documents.

Core features

graph TD
    A[Obsidian Note] --> B[WASM Engine]
    B --> C[Expand Embeds]
    B --> D[Resolve Wikilinks]
    B --> E[Convert Citations]
    B --> F[Render Mermaid]
    B --> G[Convert Equations]
    C --> H[.tex File]
    D --> H
    E --> H
    F --> H
    G --> H
    H --> I[PDF]
    H --> J[DOCX]
    H --> K[InDesign]

Feature matrix

Feature Status Description
Wikilinks ✅ [[Note]] → \hyperref[...]{}
Embeds ✅ ![[Note]] → recursive expansion
Citations ✅ @citation → \citep{} + arrows
Equations ✅ $math$ → LaTeX equations
Mermaid ✅ ```mermaid `` → PNG
Callouts ✅ > [!note] → tcolorbox
Footnotes ✅ [^1] → \footnote{}
Tables ✅ Markdown tables → LaTeX tables
Images ✅ ![[image.png]] → \includegraphics{}
Cross-references ✅ Bidirectional navigation ↑↓

Input → Output

Input: 

See [[Related Work]] for details.

Output: 

See \hyperref[related-work]{Related Work} for details.

Embeds

Input: 

![[Important Note]]

Output: 

\input{important_note}

Citations

Input: 

As shown by @smith2020...

Output: 

As shown by \citep{smith2020}...

Equations

Input: 

$$E = mc^2$$

Output: 

\begin{equation}
E = mc^2
\end{equation}

Mermaid diagrams

Input: 

```mermaid
graph TD
    A[Input] --> B[Output]
```

Output: 

\includegraphics{figures/diagram_1.png}

Callouts

Input: 

> [!note]
> This is important.

Output: 

\begin{tcolorbox}[colback=blue!5!white, colframe=blue!75!black]
This is important.
\end{tcolorbox}

Citation navigation

MergDown2TeX adds bidirectional arrows to citations:

% In text
As shown by \citep{smith2020}... ↑

% In bibliography
\textbf{Smith, J. (2020).} Important Research. ↓

graph LR
    A[Text] -->|↑| B[Citation]
    B -->|↓| C[Bibliography]

Embed expansion

MergDown2TeX recursively expands ![[Note]] with depth limit:

graph TD
    A[Main Note] --> B[![[Note A]]]
    A --> C[![[Note B]]]
    B --> D[![[Sub Note 1]]]
    B --> E[![[Sub Note 2]]]
    C --> F[![[Sub Note 3]]]

Features: - Depth limit (default: 10) - Circular reference detection - Filesystem resolution

Mermaid rendering

MergDown2TeX renders Mermaid diagrams to PNG:

Input: 

```mermaid
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Action 1]
    B -->|No| D[Action 2]
```

Output: 

\includegraphics{figures/diagram_1.png}

Supported diagrams: - Flowcharts - Sequence diagrams - Class diagrams - State diagrams - Gantt charts - Pie charts

Image resolution

MergDown2TeX resolves images relative to the markdown file:

graph TD
    A[Note Location] --> B[Check: Same Folder]
    B -->|Found| C[Use Image]
    B -->|Not Found| D[Check: Vault Root]
    D -->|Found| C
    D -->|Not Found| E[Error]

Next steps