# -*- mode: org -*-
#+TITLE:     Introduction à Markdown
#+AUTHOR:    Arnaud Legrand
#+DATE: June, 2018
#+LANG:    fr
#+STARTUP: overview indent
#+OPTIONS: num:nil toc:t


Voici un aperçu rapide de la syntaxe Markdown repris d'une
[[https://guides.github.com/features/mastering-markdown/][présentation de Github]] ainsi que de celles d'[[http://csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/][Archer Reilly]].
* Syntaxe
** Headers
#+BEGIN_EXAMPLE
 # This is an <h1> tag
 ## This is an <h2> tag
 ###### This is an <h6> tag
#+END_EXAMPLE

** Emphasis
#+BEGIN_EXAMPLE
 *This text will be italic*
 _This will also be italic_

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

 _You **can** combine them_
#+END_EXAMPLE

** Lists
*** Unordered
#+BEGIN_EXAMPLE
 - Item 1
 - Item 2
   - Item 2a
   - Item 2b
#+END_EXAMPLE
*** Ordered
#+BEGIN_EXAMPLE
  1. Item 1
  2. Item 2
  3. Item 3
     1. Item 3a
     2. Item 3b
#+END_EXAMPLE
** Images
#+BEGIN_EXAMPLE
 ![GitHub Logo](/images/logo.png)
 Format: ![Alt Text](url)
#+END_EXAMPLE
** Links
#+BEGIN_EXAMPLE
 http://github.com - automatic!
 [GitHub](http://github.com)
#+END_EXAMPLE
** Blockquotes
#+BEGIN_EXAMPLE
 As Kanye West said:

 > We're living the future so
 > the present is our past.
#+END_EXAMPLE
** Inline code
#+BEGIN_EXAMPLE
To print some text with python, you should use the `print()` function.
```
print("Hello world!")
```
#+END_EXAMPLE
* É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:

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

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

#+BEGIN_EXAMPLE
Cette expression est mise en valeur:

$$\sum_{i=1}^n X_i$$
#+END_EXAMPLE
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 [[http://www.statpower.net/Content/310/R%2520Stuff/SampleMarkdown.html][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}$= |