Leçon 2.4 Installer Pandoc

Division: “MODULE 2 : INSTALLATION

Leçon: 2.4 – Installer Pandoc

⏰ Durée: “10 min

Difficulté : ★★☆☆☆ Moyen

Prérequis : Leçon 2.3 (Longform installé)

⏩ Progression: “Leçon 2/5 du module 2

📚 Qu'est-ce que Pandoc ?

Le Convertisseur Universel

Pandoc est un convertisseur de documents qui transforme vos fichiers Markdown en formats professionnels.

Avec Pandoc, vous pourrez exporter vos manuscrits vers :

✓ Word (.docx) – Pour envoi aux éditeurs
✓ PDF – Pour publication ou partage
✓ HTML – Pour site web ou blog
✓ EPUB – Pour livres électroniques
✓ Et 40+ autres formats !

Pourquoi Pandoc est Indispensable

Sans Pandoc :

Avec Pandoc :

Pandoc est LE pont entre Obsidian et le monde de l’édition ! 🌉

Plus précisément :

Longform compile vos chapitres → en un seul fichier Markdown
Pandoc transforme ce Markdown → en Word, PDF, EPUB, etc.
Les deux travaillent ensemble pour votre workflow complet

⚠️ IMPORTANT : Deux Installations Nécessaires

Pandoc nécessite DEUX installations distinctes :

1️⃣ PANDOC (logiciel système)
↓ Sur votre ordinateur

2️⃣ PLUGIN PANDOC (dans Obsidian)
↓ Dans Obsidian

Les deux sont nécessaires ! Le plugin Obsidian utilise le logiciel système.

📦 PARTIE 1 : Installation du Logiciel Système

⚠️ À Faire EN PREMIER

Installez d’abord le logiciel système, PUIS le plugin Obsidian.

Étape 1 : Téléchargement

Rendez-vous sur : https://pandoc.org/installing.html
Cliquez sur “Download the latest installer for Windows”
Téléchargez le fichier `.msi` (environ 30 MB)

Étape 2 : Installation

Ouvrez l’Invite de commandes :
- Appuyez `Windows + R`
- Tapez `cmd`
- Appuyez `Entrée`
Dans l’invite de commandes, tapez :
```
pandoc --version
```
Appuyez sur Entrée

Résultat attendu :

pandoc 3.1.11
Features: +server +lua
Scripting engine: Lua 5.4

Méthode Recommandée : Installateur

Rendez-vous sur : https://pandoc.org/installing.html
Téléchargez le fichier `.pkg` pour macOS
Double-cliquez sur le fichier téléchargé
Suivez l’assistant d’installation
Entrez votre mot de passe administrateur si demandé
Terminez l’installation

Vérification (macOS)

Ouvrez Terminal :
- Spotlight (`Cmd + Espace`)
- Tapez “Terminal”
- Appuyez `Entrée`
Tapez
pandoc –version
Appuyez sur Entrée

Résultat attendu Numéro de version affiché

✅ Installation réussie !

🐧 Ubuntu / Debian / Linux Mint

Ouvrez un terminal et tapez :

				
					sudo apt update
sudo apt install pandoc

Entrez votre mot de passe quand demandé.

Fedora / Red Hat / CentOS

				
					sudo dnf install pandoc

Arch Linux / Manjaro

				
					sudo pacman -S pandoc

Vérification (Linux)

Dans le terminal, tapez :
pandoc –version

✅ Si version affichée → Installation réussie !

✅ Checkpoint PARTIE 1

Avant de passer à la Partie 2, vérifiez que :

☑ Pandoc est téléchargé et installé
☑ La commande `pandoc –version` fonctionne
☑ Un numéro de version s’affiche (ex: 3.1.11)

Tout est bon ? Passons à l’installation du plugin Obsidian ! 🚀

🔌 PARTIE 2 : Installation du Plugin Obsidian

Prérequis

⚠️ Avant de continuer, assurez-vous que :

Étape 1 : Activer les Community Plugins

Si ce n’est pas déjà fait (vous l’avez normalement fait pour Longform) :

Cliquez sur ⚙️ Paramètres (en bas à gauche)
Allez dans “Community plugins”
Cliquez “Turn on community plugins”
Confirmez

Étape 2 : Installer le Plugin Pandoc

Dans Community plugins, cliquez “Parcourir”.
Dans la barre de recherche, tapez : “pandoc “
Trouvez le plugin “Pandoc Plugin“
- Auteur : Oliver Balfour
- Description : “Adds command palette options to export your notes…”
Cliquez sur le plugin pour ouvrir sa page
Cliquez “Install” (Installer)
Attendez quelques secondes
Cliquez “Enable” (Activer)

✅ Le plugin est installé et activé !

Étape 3 : Configurer le Plugin

Fermez la fenêtre de parcours (❌)
Dans Paramètres, section “Community plugins” (menu gauche)
Cliquez sur “Pandoc Plugin“

Configuration Automatique (Idéal)

Si le plugin détecte Pandoc automatiquement :

Le champ “Pandoc path” affiche le chemin (ex: `/usr/local/bin/pandoc`)

✅ Parfait ! Pas besoin de configuration manuelle.

Configuration manuelle

Configuration Manuelle (Si Nécessaire)

Si le champ “Pandoc path” est vide :

Chemins typiques :
Windows

C:\Program Files\Pandoc\pandoc.exe

macOS

/usr/local/bin/pandoc

ou (si installation avec hombrew)

/opt/homebrew/bin/pandoc

Pour trouver le chemin exact :

Windows (invite de commande)

where pandoc

macOS. linux (terminal)

which pandoc

🧪 Test de Fonctionnement

Créons un Document Test

Créez une nouvelle note dans Obsidian (Ctrl+N / Cmd+N)
Nommez-la : `Test Export Pandoc`
Écrivez ce contenu :

				
					# Mon Premier Export Pandoc

Ceci est un test d'export avec **Pandoc** !

## Section 2

Voici une liste :

- Point 1
- Point 2
- Point 3

Texte en *italique* et en **gras**.

> Citation importante

C'est tout pour ce test. 🎉

Exportons Vers Word

Ouvrez la palette de commandes :
- Windows/Linux : `Ctrl + P`
- macOS : `Cmd + P`
Tapez : `pandoc`
Sélectionnez : “Pandoc Plugin: Export as Word document (.docx)“

Le fichier prendra le nom de la note actuelle et sera placer par défaut dans le mème dossier que celle-ci

⏳ Attendez 1-2 secondes…

Le fichier prendra le nom de la note actuelle et sera placer par défaut dans le mème dossier que celle-ci

Vérification du Résultat

Ouvrez le fichier `test-export.docx` généré
Vérifiez que :

✅ Titre “Mon Premier Export Pandoc”** affiché en grand (Titre 1)
✅ “Section 2″** en titre niveau 2
✅ Liste à puces correctement formatée
✅ Texte en gras et _italique_ préservé
✅ Citation avec mise en forme spéciale

Si tout est bon : FÉLICITATIONS ! 🎉

Pandoc fonctionne parfaitement !

⚠️ Note sur l'Export PDF

Pandoc peut exporter en PDF, mais cela nécessite l’installation de LaTeX, un système très lourd :

Taille : 4-7 GB d’espace disque
Installation : 30-60 minutes
Complexité : Élevée pour débutants
Résultat : PDF basique

💡 Ma Recommandation :

Pour vos besoins d’écrivains, la méthode Word → PDF ou **Word → Affinity → PDF est beaucoup plus simple et donne de meilleurs résultats.

Vous économisez de l’espace disque, du temps d’installation, et vous obtenez de meilleurs résultats !

⚠️ Dépannage

Problème 1 : “pandoc: command not found”

Symptôme : La commande `pandoc –version` retourne une erreur.

Cause : Pandoc n’est pas correctement installé.

Solution :

Désinstallez Pandoc (si partiellement installé)
Redémarrez votre ordinateur
Réinstallez Pandoc en suivant Partie 1
Testez à nouveau `pandoc –version`

Problème 2 : Plugin ne trouve pas Pandoc

Symptôme :Champ “Pandoc path” vide, ou erreur lors de l’export.
Solution :

Trouvez le chemin exact :
Windows (Invite de commandes) :
```
where pandoc
```
macOS/Linux (Terminal) :
```
which pandoc
```
Copiez le résultat affiché
Collez-le dans “Pandoc path” (paramètres plugin)
Redémarrez Obsidian

✅ Checklist Finale

Avant de passer à la leçon suivante :

Logiciel Système

☐ Pandoc téléchargé et installé
☐ Commande `pandoc –version` fonctionne
☐ Version récente affichée (3.x)

Plugin Obsidian

☐ Plugin “Pandoc Plugin” installé
☐ Plugin activé
☐ Chemin Pandoc configuré (auto ou manuel)

Tests

☐ Note test créée
☐ Export vers .docx réussi
☐ Fichier .docx s’ouvre correctement
☐ Mise en forme préservée

☑ Tout coché ? Vous êtes prêt ! 🎉

🎉 Félicitations !

Pandoc est maintenant installé et fonctionnel !

Vous pouvez désormais :

✓ Exporter vos manuscrits vers Word
✓ Préparer vos textes pour envoi aux éditeurs
✓ Créer des PDF via Word (méthode simple)
✓ Utiliser Longform avec export automatique (Module 3)

Pour des PDF professionnels : → Module 5 : Workflow Affinity Publisher

🚀 PROCHAINE ÉTAPE

Dans la prochaine leçon, nous installerons les derniers plugins utiles pour optimiser votre workflow d’écriture.

Obsidian

Détails