mdown

mdown est un petit programme écrit en C, dont je suis l’auteur. Il permet de convertir des documents écrits dans une syntaxe proche du texte naturel en divers formats, dont le XHTML et le LaTeX.

Il sait aussi générer du ZCode, utilisé sur le Site du Zéro. Son existence est en partie due à l’inconfort ressenti à l’usage du ZCode, et la volonté d’un petit groupe d’avoir une alternative pour pouvoir continuer à publier sur le SdZ sans pourtant avoir à écrire en ZCode.

Il est utilisé pour l’écriture des pages de ce site.

Développement et téléchargement

La dernière version peut être téléchargée à partir de mon dépôt Git. Il faut bien faire attention à sélectionner la branche m2, qui contient les derniers développements en vue d’une transition future vers mdown2. la syntaxe supportée diffère en de multiples aspects (mineurs) de celle utilisée par mdown1.

Un petit récapitulatif des changements syntaxiques apportés :

• Changement de délimiteur de titres : #.
• Changement de délimiteur d’emphase : * (possiblement répété).
• Changement de syntaxe de retour à la ligne forcé : | en fin de ligne.
• Ajout d’un délimiteur de fin de ligne de tableau : |.
• Introduction de ' pour le style alternatif (p.ex. locution étrangère).
• Changement de syntaxe de liens :
  • [texte](adresse) pour un lien direct ;
  • [texte|étiquette] pour un lien indirect ;
  • [texte] équivaut à [texte|texte] ;
  • [! (même syntaxe que ci-dessus) introduit une image ;
  • [. introduit une ancre.
• Changement de délimiteurs de liste associative : + introduit un élément et une tabulation ou un retour à la ligne marque la fin de la tête.
• Suppression du support des marqueurs de langue.
• Suppression du support des abréviations.
• Suppression de la syntaxe pré-mdown-1 (' et ").

Pour l’heure, le manuel fourni n’est plus à jour. Veuillez vous reporter au code et aux messages de log pour plus de détails.

Ancien historique

Cet historique concerne la version 1 de mdown, que je maintenais sous RCS. Les journaux de révision étant maintenant disponibles via Git, je vous invite à les consulter directement.

mdown 1.146 : Bugfix release

Juste un petit problème avec les flottants du ZCode. La doc a été mise à jour aussi, toujours pour le ZCode.

mdown 1.144 : Meilleur support du ZCode

Notamment, les espacements verticaux entre les puces sont maintenant semblables à ceux entre les autres blocs.

J’ai également inclus un fichier tags tutozcode.tags que vous pouvez utiliser (en le passant en argument à l’option -T) pour produire des fichiers en ZCode plus adaptés à un tutoriel ; le changement principal est que les niveaux de titres sont décalés (le second niveau vaut <titre1>, etc.), ce qui vous permet d’utiliser les titres de niveau 1 pour délimiter les parties de votre tuto.

Je ferai sûrement un fichier tags pour produire un fichier XML conforme à ce que le SdZ attend dans Vos Tutos, lorsque celui-ci acceptera à nouveau les uploads et que j’aurai le temps.

mdown 1.141 : Correction de bugs mineurs

Support d’environnements intrinsèques supplémentaires pour la sortie ZCode.

mdown 1.135 : Correction d’un bug lié aux environnements intrinsèques

Celui-ci faisait que mdown ne prenait pas en compte les environnements intrinsèques correctement. Modification légère de la syntaxe des acronymes : ceux-ci doivent maintenant débuter par un caractère non blanc qui n’est pas un caractère de ponctuation.

mdown 1.134 : Support du ZCode amélioré

Travail sur les espacements verticaux.

mdown 1.132 : Petite mise à jour (bugfix)

Elle corrige un bug qui faisait que mdown ne transformait pas les URL des images selon les règles d’URL personnalisées.

mdown 1.131 Changements de syntaxe incompatibles

Ces changements sont incompatibles avec les versions précédentes : ajout d’un support pour les acronymes/sigles et d’un marquage pour les locutions étrangères et latines ; suppression de la sémantique de ' et " qui sont maintenant des caractères normaux. Pour plus de détails sur les raisons, voyez la page man.

Et bien sûr, comme toutes les autres versions, elle apporte son lot de corrections de bugs (principalement des implantations incomplètes de fonctionnalités dans certaines parties du programme).

mdown 1.122 : Corrections de bugs

Régularisation des espaces pour la sortie LaTeX.

mdown 1.119 : Ajout du support des liens personnalisés

Un peu à la manière des environnements ; il est maintenant possible d’écrire [](wpfr:article) pour faire référence à un article de la Wikipédia. Cette fonctionnalité n’est bien sûr pas limitée aux liens vers la Wikipédia, c’est, en vérité, un module de réécriture des liens simple qui vous permettra d’implanter les raccourcis qui conviennent à votre travail.

Cette version corrige également un problème qui estropiait un paragraphe débutant par un nombre en le méprenant pour le début d’un élément de liste ordonnée.

mdown 1.111 : Première distribution publique