.. index::
   pair: Documentation; Markdown


.. _markdown:

=======================
Markdown
=======================

.. seealso::

   - http://fr.wikipedia.org/wiki/Markdown
   - http://en.wikipedia.org/wiki/Markdown
   - http://michelf.com/projects/php-markdown/extra/#table
   - http://devdocs.io/markdown/


.. contents::
   :depth: 3

Introduction
============

Markdown est un langage de balisage léger créé par :ref:`John Gruber <john_gruber>`
et :ref:`Aaron Swartz <aaron_swartz>`.

Le but de la syntaxe Markdown est d'offrir une syntaxe facile à lire et à
écrire.

C'est-à-dire qu'un document formaté selon Markdown devrait pouvoir être publié
comme tel, en texte, sans donner l’impression qu’il a été marqué par des balises
ou des instructions de formatage.

Bien que la syntaxe Markdown ait été influencée par plusieurs filtres de
conversion de texte vers HTML existants — incluant Setext, atx, Textile,
reStructuredText, Grutatext et EtText — la source d’inspiration principale de
la syntaxe Markdown est le format du courrier électronique en mode texte.


People
=======

.. toctree::
   :maxdepth: 4


   people/index



Tools
=========

.. toctree::
   :maxdepth: 4


   tools/index


Tutorials
=========

.. toctree::
   :maxdepth: 4


   tutorials/index