Mode majeur pour éditer du Markdown avec Emacs

Ce tutoriel s'adresse aux utilisateurs et utilisatrices de GNU Emacs et ses dérivés, ainsi qu'aux curieux et curieuses.

Le Markdown est un format minimaliste bien pratique pour formater du texte. Malheureusement, au moins jusqu'à la version 24.4, GNU Emacs ne le supporte pas. Mais il est existe un mode majeur écrit en Emacs Lisp et qui est bien entendu libre (sous licence GPL 2+).

Télécharger

Télécharger via un gestionnaire de sources de paquets

Le mode majeur pour Markdown est disponible sous forme de paquet au moins avec ces systèmes :

Sous Debian, Trisquel et Ubuntu, vous pouvez installer le paquet avec un shell texte (avec apt-get install emacs-goodies-el ou aptitude install emacs-goodies-el ou apt install emacs-goodies-el) ou via une interface graphique (comme Synaptic).

Télécharger via le Web

La dernière version stable est disponible sur le site de l'auteur de ce mode. Vous pouvez aussi télécharger la dernière version du dépôt git.

Télécharger via le dépôt Git

Si vous voulez le dépôt Git, il est disponible sur http://jblevins.org/git/markdown-mode.git. Pour le cloner via un shell texte, git clone git://jblevins.org/git/markdown-mode.git.

Installer

Placer le fichier Emacs Lisp à un endroit connu d'Emacs

Le fichier Emacs Lisp est probablement à un endroit connu d'Emacs si vous l'avez installé avec un gestionnaire de sources de paquets avec lequel vous avez aussi installé Emacs. Si ce n'est pas déjà fait, placez le fichier Emacs Lisp dans un des chemins de recherche de fichiers à charger d'Emacs. Si vous n'en avez pas, il est habituel de créer un dossier "packages" ou "elisp" dans le dossier .emacs.d, puis de l'ajouter dans votre .emacs avec (add-to-list 'load-path "~/.emacs.d/packages/") ou (add-to-list 'load-path "~/.emacs.d/elisp/"). Le fichier .emacs et le dossier .emacs.d se trouvent probablement dans votre dossier personnel, qui sous un système UNIX-like (comme une distribution GNU/Linux ou un *BSD) est facilement accessible avec "~/.emacs" ou "$HOME/.emacs" (rajoutez juste ".d" pour le dossier). Si le fichier .emacs ou le dossier .emacs.d n'existent pas dans votre dossier personnel, n'hésitez pas à les créer.

Configurer Emacs

Dans votre fichier .emacs, ajoutez :
(autoload 'markdown-mode "markdown-mode"
"Major mode for editing Markdown files" t)
(add-to-list 'auto-mode-alist '("\\.text\\'" . markdown-mode))
(add-to-list 'auto-mode-alist '("\\.markdown\\'" . markdown-mode))
(add-to-list 'auto-mode-alist '("\\.md\\'" . markdown-mode))

En savoir plus