Quarkdown 2.0 - Du Markdown qui crache PDF, slides et wikis

Image illustrant l’article : Quarkdown 2.0 - Du Markdown qui crache PDF, slides et wikis

1. Quarkdown 2.0 ajoute un système de permissions pour contrôler ce qu’un document peut faire lors de la compilation (–deny network, --deny global-read), utile pour compiler des documents reçus sans vérification préalable.
2. L’output HTML fonctionne maintenant sans réseau puisque polices et thèmes sont intégrés au dossier de sortie, permettant de distribuer le rendu sur clé USB en quasi-autonomie.
3. Le dossier de sortie change de ./output à ./quarkdown-output en v2.0.0, nécessitant une adaptation des scripts CI existants.

Quarkdown vient de passer en v2.0.0, et c’est une mise à jour qui en jette ! Pour ceux qui auraient raté le projet de Giorgio Garofalo, c’est ce compilateur Markdown capable de cracher livres, slides, PDF académiques et wikis à partir du même projet.

J’en avais parlé il y a presque un an dans cet article , et le truc a bien grossi depuis.

Du Kotlin sous le capot, et surtout une v2 qui ajoute le truc qu’on attendait pas : un vrai système de permissions ! En gros, vous pouvez maintenant brider ce qu’un document Quarkdown a le droit de faire pendant la compilation. Ça se contrôle avec des flags comme (pour bloquer l’accès réseau) ou (pour empêcher la lecture de fichiers en dehors du projet) à la compilation. C’est pratique quand vous compilez un document que quelqu’un vous a envoyé sans trop savoir ce qu’il y a dedans.

L’autre nouveauté qui change la vie, c’est l’output HTML qui peut maintenant tourner sans réseau. Plus besoin de pinger un CDN au moment du rendu puisque toutes les polices et les thèmes sont copiés dans le dossier de sortie. Par contre, maintenant les fichiers pèsent plus lourd mais c’est un bon compromis quand même puisque vous pouvez balancer le HTML sur une clé USB et ça tourne en quasi-autonomie (sauf si vous chargez des Google Fonts custom ou des polices cheloues, qui restent distantes).

Côté SEO, la fonction peut générer un sitemap.xml et des canonical links si vous lui passez un , ce qui le rend utilisable pour publier de vrais sites statiques.

Pour le reste, y’a plein de petits trucs sympas : les cross-références (figures, tables, équations) sont enfin cliquables, la fonction affiche les raccourcis clavier avec ⌘ sur Mac et Ctrl ailleurs, et le rendu se parallélise sur les éléments frères. Ah, et un détail qui va surprendre ceux qui mettent à jour : le dossier de sortie passe de à , donc faudra adapter vos scripts CI !

Côté installation, ils ont aussi simplifié tout ça : Homebrew sur Mac (), Scoop sur Windows, ou les habituels scripts shell. Attention quand même, faut se taper la syntaxe Quarkdown plutôt que du Markdown pur, ce qui est un nouveau dialecte à apprendre, mais c’est pas non plus la mer à boire, donc pas de stress.

Bref, si vous cherchez une alternative à LaTeX ou un complément à Pandoc pour votre workflow doc, c’est peut-être le bon moment de tester !

Source

Cet article peut contenir des images générées à l’aide de l’IA - J’apporte le plus grand soin à chaque article, toutefois, si vous repérez une boulette, faites-moi signe !

Alors rejoignez ma communauté sur Patreon et accédez à des articles exclusifs, des tutos avancés et plein d’autres surprises que je réserve à mes soutiens. C’est grâce à vous que je peux continuer à partager ma passion depuis 20 ans !

Vous êtes développeur web ? Alors vous allez adorer les nouvelles offres de o2switch, conçues spécialement pour vous !

Illustration représentant l’offre d’hébergement o2switch pour les développeurs

Profitez d’une puissance inégalée : Cloud avec 12 CPU et 48 Go de RAM à 1,86 € HT/mois, ou Pro avec 24 CPU et 64 Go de RAM à 6,25 € HT/mois. Déployez vos projets en quelques clics grâce à Softaculous et ses + de 300 scripts prêts à l’emploi.

La vitesse, vous aimez ? Eux aussi ! C’est pour ça qu’ils vous font fait profiter de la technologie NVMe dernière génération et de puissants caches comme Varnish et LiteSpeed. Tout ça avec la sérénité d’un hébergement français sécurisé par un WAF sur-mesure, des sauvegardes jusqu’à 90 jours (selon l’offre) et un support prioritaire 24/7 (N2 à N2+3 selon l’offre).

Et vous savez quoi ? Les offres démarrent à seulement 1,86 € HT/mois. Foncez, c’est le moment de coder sans limites et de donner vie à vos projets les plus fous grâce à o2switch !