Parlons technique : Connaissez-vous le format markdown ?
Le markdown est un format très utilisé par la communauté des développeurs Open Source. Il sert essentiellement pour les fichiers README d’un projet mais pas seulement.
Une documentation complète peut être rédigée dans ce format. L’extension de son nom de fichier est « .md » ou « .markdown ».
Le document est au format texte et contient quelques marqueurs spécifiques pour indiquer la nature des différentes parties d’un document. Il y a entre autres les niveaux de paragraphe, les tableaux, les listes, les citations et les hyperliens. La liste des possibilités n’est pas exhaustive.
L’intérêt de ce format est double. D’une part, le document est lisible tel quel, les marqueurs n’étant pas encombrants, et d’autre part, le rendu est cohérent et uniquement dépendant d’une feuille de style.
Un guide très complet en anglais est disponible à cette adresse : markdownguide