mergdowntotex

What it does

MergDown2TeX transforme une note Obsidian en un document prêt à publier (LaTeX, PDF, DOCX, InDesign). Tout est fusionné automatiquement :

Formats de sortie :

• PDF — Pandoc WASM + Typst (par défaut, fonctionne sur mobile) ou pdflatex + Podman (PC, LaTeX natif)
• DOCX — Pandoc WASM embarqué
• .typ — intermédiaire Typst
• .expanded.md — Markdown étendu autonome (embeds/liens résolus)
• InDesign compatible

How it works

┌─────────────────────────────────────────────────────────┐
│  Obsidian Note                                          │
│  ├── [[Note A]]          ──→  \hyperref + expansion    │
│  ├── ![[Note B]]         ──→  recursive expansion      │
│  ├── ![[image.png]]      ──→  \includegraphics{}       │
│  ├── @citation           ──→  \citep{} + arrows ↑↓     │
│  ├── $math$              ──→  LaTeX equation            │
│  └── ```mermaid```       ──→  PNG (bundle embarqué)     │
└─────────────────────────────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────┐
│  WASM Engine (embarqué dans main.js, Base64)            │
│  ├── Markdown → LaTeX conversion (moteur Rust/WASM)     │
│  ├── Embed expansion + wikilinks + ancres de blocs      │
│  ├── Citation extraction + navigation (↑↓)              │
│  └── Mermaid → PNG (mermaid.min.js embarqué)            │
└─────────────────────────────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────┐
│  Compilation (auto, sans installation)                  │
│  ├── pandoc.wasm   : .tex → .docx                       │
│  ├── typst.wasm    : .typ → .pdf                        │
│  └── (option) pdflatex + Podman : .tex → .pdf (PC)      │
└─────────────────────────────────────────────────────────┘

Dependencies

pandoc.wasm (59 MB), typst.wasm (28 MB) et leurs polices sont auto-téléchargés dans wasm/ au premier export (bouton manuel dans les réglages sinon).

PDF natif LaTeX (optionnel, PC) — construit le conteneur :

podman build -t vlatex-env -f Dockerfile.vlatex .
# ou : docker build -t vlatex-env -f Dockerfile.vlatex .

Install

Téléchargements

Tous les zips sont servis par la release bundle (assets de release GitHub → bande passante illimitée) ainsi que par ce site.

• Bundle → dézippé, vous obtenez mergdowntotex/ (à copier dans .obsidian/plugins/) et example_vault/ (vault prêt à ouvrir).
• Plugin seul → dézippez et placez le dossier mergdowntotex/ dans .obsidian/plugins/.
• Les moteurs pandoc.wasm (59 MB) et typst.wasm (28 MB) sont déjà inclus dans les archives ; sinon ils s'auto-téléchargent au premier export.
• Mobile : les moteurs sont téléchargés compressés, un zip par composant, jamais mélangés — pandoc_wasm.zip (15 Mo) pour le DOCX ; typst_wasm.zip (10 Mo) et typst_fonts.zip (8 Mo) pour le PDF — au lieu des fichiers bruts (59 Mo + ~28 Mo + ~11 Mo). On ne télécharge que ce qui manque ; dans les réglages, 3 cases à cocher + un seul bouton « Télécharger la sélection » (le dossier d'exemple est en tête de l'onglet pour le récupérer en premier).

Manuel

1. Télécharge main.js et manifest.json depuis Releases (ou utilisez le bundle ci-dessus)
2. Copie-les dans .obsidian/plugins/mergdowntotex/
3. Active dans Settings → Community Plugins

main.js (~3.7 MB) embarque le moteur de conversion WASM en Base64. Le rendu Mermaid (mermaid.min.js) est auto-téléchargé au premier export, et les moteurs pandoc.wasm/typst.wasm aussi.

Structure du plugin (release et vault exemple)

mergdowntotex/                        ← dossier du plugin (id = mergdowntotex)
├── main.js          ~3.7 MB          ← plugin + moteur WASM embarqué (Base64)
├── manifest.json      1.2 KB         ← métadonnées
├── wasm/                             ← auto-téléchargé (pandoc.wasm, typst.wasm, fonts)
└── resources/                        ← ressources (CSL/BIB auto-hébergés, mermaid.min.js)

Vault exemple : le zip full_manual_repport_exp.zip (ou le dossier example_vault/ du dépôt) contient un vault prêt à l'emploi avec le plugin déjà installé (.obsidian/plugins/mergdowntotex/). Cette installation est strictement identique à celle de la release (mêmes main.js, manifest.json, wasm/, resources/).

Commands

Raccourci rapide : bouton PDF dans le ruban.

Why MergDown2TeX?

Pandoc GUI (plugin Obsidian pandoc-gui) fournit une interface de conversion mais requiert toujours Pandoc + un environnement LaTeX externe et ne résout pas les wikilinks/embeds Obsidian natifs.

vlatex & le moteur WASM

Le moteur de conversion (et son outillage) est développé dans le projet vlatex. Pour en savoir plus sur vlatex / vlatex wasm et son intégration avec Obsidian :

https://dvrch.github.io/vlatex/obsidian/

Architecture

Release (2 fichiers) :

mergdowntotex/
├── main.js          ~3.7 MB   ← plugin + moteur WASM embarqué (Base64)
└── manifest.json     1.2 KB   ← metadata

main.js embarque :

• le moteur de conversion WASM (Markdown → LaTeX), encodé en Base64 (WASM_BASE64).

Le bundle Mermaid (mermaid.min.js) est téléchargé au runtime (CDN/site, ou resources/mermaid.min.js en mode hors-ligne) pour le rendu client-side, y compris sur mobile — il n'est pas embarqué dans main.js.

Les moteurs pandoc.wasm/typst.wasm (trop volumineux pour être embarqués) sont auto-téléchargés dans wasm/ au premier export.

Développement (dans le repo) :

mergdowntotex/
├── main.js          ~3.7 MB   ← même fichier que la release
├── manifest.json     1.2 KB
├── wasm/
│   ├── pandoc.wasm   ~59 MB
│   ├── typst.wasm    ~28 MB
│       └── fonts/
└── resources/
    ├── csl/                     ← styles de citation auto-hébergés
    └── mermaid.min.js           ← bundle Mermaid (offline)

Mermaid : le bundle mermaid.min.js est téléchargé au runtime (CDN/site, avec resources/mermaid.min.js prévu pour le hors-ligne) — il n'est pas encodé en Base64 dans main.js. scripts/ └── bundle-release.js ← encode WASM → Base64 → injecte dans main.js

**Build release automatisé** par GitHub Actions :

```mermaid
graph LR
    A[git tag 1.0.x] --> B[GitHub Actions]
    B --> C[bundle-release.js]
    C --> D[main.js + WASM]
    D --> E[Release]

Zero build step. Moteur WASM embarqué dans main.js à la release.

Troubleshooting

« WASM module not loaded »

• Vérifie que main.js fait bien ~3.7 MB (un fichier plus petit = build dev sans moteur embarqué)
• Re-télécharge la release si le fichier semble corrompu
• Redémarre Obsidian

pandoc.wasm / typst.wasm introuvable

• Lance un export, ou clique sur le bouton de téléchargement dans les réglages
• Vérifie la connexion internet (59 MB + 28 MB)

« podman: command not found » (PDF natif)

• Installe Podman/Docker, ou active PDF PC via Wasm+Typst dans les réglages (aucune installation)

License

MIT

Support

• GitHub Issues
• Documentation