Les sources principales de documentation :

• Le projet Markdown sur Daring Fireball
• CommonMark (GitHub)
• Pandoc : a universal document converter (GitHub)
• Élaboration et conversion de documents avec Markdown et Pandoc

On peut utiliser le plugin vim-markdown (attention notamment à insérer let g:vim_markdown_folding_disabled=1 dans le .vimrc pour éviter le repli).

Personnellement, je ne suis pas tout à fait satisfait de ce plugin, c'est peut-être aussi que je ne sais pas l'utiliser correctement, mais j'ai des auto-indentations étranges, qui n'impactent pas le rendu, mais me dérangent au niveau de la lecture de la source en .md.

Ce qui fonctionne bien, c'est de faire en sorte que vim reconnaisse bien le filetype : :set filetype=markdown ou carrément l'ajouter dans le .vimrc :

au BufRead,BufNewFile *.md set filetype=markdown