Quarkdown - Du Markdown avec des super pouvoirs pour les tech

Vous en avez marre de galérer avec LaTeX pour rédiger vos docs techniques ? Et bien de mon côté, j’ai découvert Quarkdown et c’est vraiment cool, vous allez voir.

Quarkdown, c’est donc le projet coup de coeur de Giorgio Garofalo, un étudiant en ingénierie à l’université de Bologne qui a eu une idée de génie : et si on combinait la simplicité de Markdown avec la puissance de LaTeX ? Le résultat, est donc un système de composition moderne qui compile en millisecondes là où LaTeX nous fait poireauter des secondes entières.

Le truc révolutionnaire avec Quarkdown, c’est qu’il transforme Markdown en langage Turing-complet. Concrètement, ça veut dire que vous pouvez créer vos propres fonctions, utiliser des variables, faire des boucles… le tout dans une syntaxe qui reste familière. Par exemple, au lieu de vous battre avec des environnements LaTeX incompréhensibles, vous écrivez simplement :

.function {greet}
to from:
**Hello, .to** from .from!

.greet {world} from:{korben}

Et hop, ça génère automatiquement “Hello, world from korben!”

Et c’est hyper polyvalent puisqu’avec le même fichier source, vous pouvez générer un PDF au look académique, une présentation interactive avec reveal.js, ou même un livre complet avec paged.js. La preuve en image avec ce rendu qui fait sérieusement concurrence aux publications scientifiques classiques :

L’aperçu en temps réel fonctionne nickel, ce qui change radicalement votre workflow d’écriture et la bibliothèque standard de Quarkdown inclut tout ce qu’il faut pour la mise en page avancée, les maths, les conditions, les E/S… Et si ça ne suffit pas, vous créez vos propres librairies.

Giorgio a pensé à tout, même aux cas d’usage les plus pointus. Vous voulez faire une table des matières ? .tableofcontents. Une image centrée ? .center. Trois colonnes d’images ? .row alignment:{spacebetween}. C’est cette approche directe qui rend Quarkdown si addictif.

Le projet vient de sortir dans sa première version stable, avec un système de plugins qui promet des extensions infinies et comparé à Typst (l’autre challenger de LaTeX), Quarkdown mise tout sur l’accessibilité… vous commencez avec du Markdown classique et vous ajoutez progressivement les fonctionnalités avancées.

Alors pour qui c’est fait ?

Et bien clairement, c’est pour tous ceux qui aiment les trucs simples (le markdown) mais qui veulent créer des documents un peu chiadés et avec un peu de complexité quand même. Non, ce n’est pas paradoxal ;-) ! Je pense aux étudiants qui galèrent avec leur thèse, les développeurs qui veulent documenter proprement leurs projets, les créateurs de contenu technique qui en ont marre des limitations de Markdown classique… Bref, nous tous quoi !

L’installation est un jeu d’enfant évidemment puisque vous téléchargez le zip depuis les releases GitHub, vous décompressez, et c’est parti. Ça tourne sur tous les OS avec Java 17+ et l’assistant de création de projet vous guidera pas à pas pour démarrer rapidement.

Alors oui, LaTeX a encore de beaux jours devant lui pour les cas ultra-spécialisés mais pour 90% de nos besoins quotidiens d’écriture technique, Quarkdown apporte exactement ce qu’il promet : la puissance sans la complexité et avec le rythme de développement actuel, je parie qu’on va voir débarquer des fonctionnalités encore plus dingues dans les mois qui viennent.

Bref, si vous rédigez régulièrement du contenu technique, testez-le dès maintenant, c’est gratuit et open source.

Source