Introduction

Qu’est-ce que leaf ?

leaf est un prévisualiseur Markdown en terminal qui offre une expérience GUI-like dans votre ligne de commande. Il rend les fichiers Markdown avec un formatage riche, une coloration syntaxique, des formules LaTeX, des diagrammes Mermaid et plus encore, le tout sans quitter votre terminal.

Fonctionnalités principales

  • Rendu Markdown riche : headers, listes, blockquotes, tableaux avec bordures Unicode, coloration syntaxique pour 40+ langages, callouts d’alerte GitHub, cases à cocher, surlignage de texte et notes de bas de page Markdown.
  • LaTeX & Mermaid : formules mathématiques en Unicode, diagrammes en ASCII art.
  • Navigation interactive : raccourcis vim-like, souris, scrollbar et recherche plein texte.
  • Table des matières : sidebar TOC avec suivi de section active, navigation à la souris et défilement automatique.
  • File picker : fuzzy finder (Ctrl+P) et navigateur de répertoire (Shift+P) avec largeur configurable.
  • Watch mode : rechargement automatique à la modification, avec conservation de la position.
  • Intégration éditeur : ouvrez vos fichiers dans votre éditeur avec Ctrl+E, à la ligne visible via {$line}.
  • Interactions sur les blocs de code : copie du contenu avec y/c puis Ctrl+Y/Entrée, numéros de ligne dans les blocs de code.
  • Capture souris : basculez la capture souris avec Shift+M pour laisser le terminal gérer la sélection de texte.
  • Rendu inline : rendu Markdown sur stdout avec --inline pour scripts et aperçus.
  • Auto-complétion : complétion Tab pour Bash, Zsh, Fish et PowerShell.
  • Thèmes personnalisés : 4 thèmes intégrés + créez les vôtres avec des fichiers TOML.
  • Types de fichiers supplémentaires : ouvrez tout fichier ; coloration syntaxique pour le code.
  • Liens cliquables : Ctrl+Click pour ouvrir, effets de survol dans les terminaux compatibles.
  • Support stdin : pipe depuis tout outil CLI (claude "..." | leaf).
  • Multi-plateforme : macOS, Linux, Windows, Android/Termux.

Démarrage rapide

# Installer
curl -fsSL https://leaf.rivolink.mg/install.sh | sh

# Prévisualiser un fichier
leaf README.md

# Watch mode
leaf --watch README.md

# Ouvrir le file picker
leaf

Étapes suivantes