Markdown : présentation

Publié le 23 juin 2012

Tags : Markdown

Markdown est un ensemble de conventions simples pour la mise en forme de texte. Le nom s’oppose au markup, où le texte est mis en forme à l’aide de balises longues à saisir.

Cette syntaxe a été conçue par John Gruber et s’inspire des conventions utilisées à l’époque où les mails ne permettaient pas de mise en forme.

C’est selon moi la meilleure syntaxe de mise en forme car elle a 3 atouts majeurs :

  1. Facile à saisir
  2. Facile à lire (même sans convertisseur)
  3. Supportée par un très grand nombre de logiciels

Exemple de texte structuré en Markdown

# Titre
Paragraphe avec *italique*, **gras** et [lien](http://example.org/).
## Sous-titre
- Liste à puce
   - Sous-liste
1. Liste numérotée

Utilisation

Vous pouvez utiliser Markdown avec les principaux logiciels de blog (Wordpress, Tumblr), ou créer un Readme pour vos projets Github.

Vous pouvez l’utiliser pour formatter vos mails sur Mac (dans MailMate) ou sur iOS (via Elements), générer une présentation, générer des documents Word ou PDF.

Vous pouvez aussi générer votre blog juste à partir de fichiers Markdown stockés dans un répertoire Dropbox avec Scriptogr.am ou Calepin !

Logiciels

Sur Mac

Il existe un grand nombre de logiciels Markdown pour Mac, certains gratuits d’autrs coûtant plusieurs dizaines d’euros. Ils proposent : prévisualisation, rappel de la syntaxe, raccourcis clavier, mode plein écran, versionnage automatique, etc. Voici une liste relativement exhaustive (je ne les ai pas tous testés en revanche).

Citons également Marked qui ne permet que de visualiser, ce que je trouve finalement peu utile avec un bon éditeur.

Sur iOS

Les principaux sont Byword, IAwriter, WriteUp, Writing Kit, Elements, Notesy. Je n’ai pas encore testé ; vos remarques et commentaires sont les bienvenus à ce sujet.

Sur Windows

Les éditeurs de Markdown pour Windows sont encore peu nombreux. Les principaux sont :

En ligne

Ajouts et améliorations

Syntaxes alternatives et concurrentes

Aucune syntaxe n’a le même niveau de support que Markdown, si vous n’avez pas besoin des spécificités de l’une ou l’autre je vous conseille de choisir Markdown.

reStructuredText

A n’utiliser que si vos logiciels vous y obligent (ou changez pour des logiciels supportant Markdown).

Textile

A utiliser si vous avez besoin de définir les classes ou identifiants appliqués à un élément, créer des notes de bas de page, et que la syntaxe vous convient.

YAML

A utiliser si vous avez besoin d’échanger des informations complexes et structurées entre différents langages de programmation, et seulement si JSON, bien plus répandu et supporté nativement par la plupart des langages de programmation, ne vous convient pas.

N’hésitez pas à signaler dans les commentaires tout logiciel, usage ou alternative qui vous paraît utile de mentionner, ou simplement donner votre avis sur le langage ou ses à-côtés.

PS : Ce billet a lui-même été rédigé en Markdown dans Byword, et converti à la volée par le plugin Wordpress Markdown on save Improved.

Page précédente Page précédente Page suivante Page suivante