Introduction à Markdown

Table of Contents

Voici un aperçu rapide de la syntaxe Markdown repris d'une présentation de Github ainsi que de celles d'Archer Reilly.

Syntaxe

Headers

# This is an <h1> tag
## This is an <h2> tag
###### This is an <h6> tag

Emphasis

*This text will be italic*
_This will also be italic_

**This text will be bold**
__This will also be bold__

_You **can** combine them_

Lists

Unordered

- Item 1
- Item 2
  - Item 2a
  - Item 2b

Ordered

1. Item 1
2. Item 2
3. Item 3
   1. Item 3a
   2. Item 3b

Images

![GitHub Logo](/images/logo.png)
Format: ![Alt Text](url)

Links

http://github.com - automatic!
[GitHub](http://github.com)

Blockquotes

As Kanye West said:

> We're living the future so
> the present is our past.

Inline code

To print some text with python, you should use the `print()` function.
```
print("Hello world!")
```

Écrire des Maths

Il est possible d'écrire des formules en Markdown, soit en mode inline soit en mode displayed formulas. Dans le premier cas, les formules sont inclues directement à l'intérieur du paragraphe courant alors que dans le second, elles apparaissent centrées et mises en exergue.

Le formatage de la formule est légèrement différent dans les deux cas car pour qu'une formule s'affiche joliment sur une seule ligne, il faut la "tasser" un peu plus que lorsqu'elle est mise en valeur.

Pour écrire une formule en mode inline, il faut la délimiter par un $ (du coup, pour écrire le symbole dollar, il faut le préfixer par un backslash, comme ceci: \$) alors que pour écrire en mode displayed, il faut la délimiter par un $$. Un petit exemple valant mieux qu'un long discours, voici concrètement comment cela fonctionne:

Cette expression $\sum_{i=1}^n X_i$ est inlinée.

Cette expression \(\sum_{i=1}^n X_i\) est inlinée.

Cette expression est mise en valeur:

$$\sum_{i=1}^n X_i$$

Cette expression est mise en valeur:

\[\sum_{i=1}^n X_i\]

Nous vous présentons par la suite une sélection de symboles et de commandes courantes. En fait, à peu près tout ce qui est classique dans le langage LaTeX peut être utilisé pourvu que vous délimitiez bien avec un $. Pour d'autres exemples plus complets jetez un coup d'œil à ces exemples de James H. Steiger.

Lettres grecques

Symbole Commande
\(\alpha\) $\alpha$
\(\beta\) $\beta$
\(\gamma\) $\gamma$
\(\Gamma\) $\Gamma$
\(\pi\) $\pi$

Fonctions et opérateurs

Symbole Commande
\(\cos\) $\cos$
\(\sin\) $\sin$
\(\lim\) $\lim$
\(\exp\) $\exp$
\(\to\) $\to$
\(\in\) $\in$
\(\forall\) $\forall$
\(\exists\) $\exists$
\(\equiv\) $\equiv$
\(\sim\) $\sim$
\(\approx\) $\approx$
\(\times\) $\times$
\(\le\) $\le$
\(\ge\) $\ge$

Exposants et indices

Symbole Commande
\(k_{n+1}\) $k_{n+1}$
\(n^2\) $n^2$
\(k_n^2\) $k_n^2$

Fractions, coefficients binomiaux, racines, …

Symbole Commande
\(\frac{4z^3}{16}\) $\frac{4z^3}{16}$
\(\frac{n!}{k!(n-k)!}\) $\frac{n!}{k!(n-k)!}$
\(\binom{n}{k}\) $\binom{n}{k}$
\(\frac{\frac{x}{1}}{x - y}\) $\frac{\frac{x}{1}}{x - y}$
\(^3/_7\) $^3/_7$
\(\sqrt{k}\) $\sqrt{k}$
\(\sqrt[n]{k}\) $\sqrt[n]{k}$

Sommes et intégrales

Symbole Commande
\(\sum_{i=1}^{10} t_i\) $\sum_{i=1}^{10} t_i$
\(\int_0^\infty \mathrm{e}^{-x}\,\mathrm{d}x\) $\int_0^\infty \mathrm{e}^{-x}\,\mathrm{d}x$

Déguisements

Symbole Commande
\(\hat{a}\) $\hat{a}$
\(\bar{a}\) $\bar{a}$
\(\dot{a}\) $\dot{a}$
\(\ddot{a}\) $\ddot{a}$
\(\overrightarrow{AB}\) $\overrightarrow{AB}$