# Ecrire en Markdown  
avec l'interface de [StackEdit](https://stackedit.io/app#)  

## Premier document  
  
* L'icône [dossier] en haut à gauche permet de créer un nouveau document
    et de le nommer (icône crayon).  
* l'icône # en haut à droite, menu Import / Export : "export as Markdown"
    sauve le fichier avec l'extension ".md".  
* Pour travailler sur un document Markdown depuis votre ordinateur :
    "Import Markdown"  
* Pour obtenir un document .html : "export as HTML", (choisir l'option
    "Plain HTML") le fichier obtenue sera lisible avec un navigateur
    internet (FireFox, Chrome...)  
* Pour obtenir un document .pdf à partir de votre document Markdown :
    le site ne le permet pas immédiatement, mais depuis le navigateur,
    on peut demander l'impression (touches [Ctrl] + [P] et spécifier le
    format .pdf).
* Quand vous serez habitués, vous pourrez taper votre texte hors ligne
    dans un éditeur quelconque, puis le copier-coller ici pour vérifier
    le rendu.

## Structure du document  
Un titre commence par un, deux ou trois # suivant son importance, suivit
d'une espace.  
Chaque appui sur la touche [Entrée] commence une nouvelle ligne ; une
ligne vide commence un nouveau paragraphe.
  
On peut écrire des listes ordonnées (il suffit de commencer par un
chiffre suivit d'un point le début de ligne, ensuite le nombre écrit
n'est pas important : si on change l'ordre des éléments (lors d'un copier
-coller par exemple), le document final est automatiquement renuméroté !
Ne pas oublier une ligne vide avant et après la liste.

1. premier élément  
2. deuxième élément ?  
3. un appui sur touche tabulation pour commencer une sous liste.  
	1. un deuxième élément de la sous liste.  
	2. ou bien ici le deuxième ?  


## Mise en forme  
pour écrire en **gras** (on tape : \*\*gras\*\*) :  penser à coller les * au mot ; 
pour écrire en _italique_ (on tape : \_italique\_)  
il existe d'autres mises en forme, mais cela est suffisant pour commencer.  

## Tableaux  
On peut créer des tableaux à l'aide des touches | (6 du clavier) et -
(6 du clavier aussi) remarquer le rôle des ":" qui formatent l'alignement
de la colonne :  

| par défaut | centré | à droite |  
|--|:--:|--:|  
| du texte | 12 | 34 |  
| 12 | texte | 34 |

## Quelques formules de maths  
Les formules s'écrivent entre deux $ $, ils doivent coller le texte !  
La syntaxe est celle du langage LaTeX (pour les curieux / courageux :
voir ici pour plus de détails :
[Formules LaTeX - Wikibook](https://fr.wikibooks.org/wiki/LaTeX/Math%C3%A9matiques)
Les exemples suivants devraient vous servir de modèles pour subvenir à
vos besoins :

* $\frac{3}{4}$ ou $\dfrac{3}{4}$  
* $\sqrt{5}$  
* $3 \times \dfrac{5}{\sqrt{6}}$  
* $\overrightarrow{AB} + \overrightarrow{AC} = \overrightarrow{AD}$  
    tel que $ABDC$ soit un parallélogramme.  
* $3 x^2 + 5x - 6 = 0 \Leftrightarrow x_1 = \dfrac{-b - \sqrt{\Delta}}{2a} ;
    x_2 = \dfrac{-b + \sqrt{\Delta}}{2a}$  
    avec $a = 3; b = 5; c = -6$ et $\Delta = b^2 - 4 ac \geqslant 0$  
* $u_{n+1} = 3 \times u_n$  
* $S = \sum_{k=0}^{n} q^{k} = \dfrac{1 - q^{n+1}}{1 -q}$  
* si $f(x) = 2 x^3 + 4 x - 5$ alors sa dérivée est : $f'(x) = 6x^2 + 4$

Un peu compliqué : un tableau de variations !

|$x$|$-\infty$| | -2 | |3| |$+\infty$|  
|----|:-----------|:---:|:---:|:---:|:--:|:---:|---:|  
|signe de $f'(x)$ | |+ | 0 | - | 0 | +| |  
| | | | 10 | | | | 7 |  
|variations de $f$ | |$\nearrow$ | |$\searrow$ | |$\nearrow$ | |  
| |-5 | | | |1 | | |  

ou bien en LaTeX :
$\begin{array}{|l|lcccccr|} 
\hline x & -\infty & & -1 & & 5 & &+\infty \\\hline
\text{signe de } f'(x) & & + & 0 & - & 0 & + & \\\hline
& & & 10 & & & & \\ 
\text{variations de } f & & \nearrow & & \searrow & & \nearrow & \\ & & & & & -3 & & \\\hline 
\end{array}$

**Astuce:**
commencer par écrire les symboles $, la formule devrait être mise en forme
au fur et à mesure.

## Formules de chimie

* $CH_4 + O_2 \longrightarrow CO_2 + 2 H_2O$
* $Cu^{2+}_{(aq)} + Zn_{(s)} \longrightarrow Cu_{(s)} + Zn^{2+}_{(aq)}$

avec les lettres droites, sous cette interface, c'est plus compliqué à
écrire...
* $\text{CH}_4 + \text{O}_2 \longrightarrow \text{CO}_2 + 2 \text{H}_2\text{O}$

* $\text{Cu}^{2+}_{(aq)} + \text{Zn}_{(s)} \longrightarrow \text{Cu}_{(s)}+
 \text{Zn}^{2+}_{(aq)}$


## Logiciels  
Pour travailler hors-ligne il existe des logiciels gratuits, mais tous
ne mettent pas en forme les formules de maths.  
On peut toujours taper son texte dans un simple éditeur de texte tel
que [NotePad++](https://notepad-plus-plus.org/)
(gratuit et multiplateforme) puis l'ouvrir dans cette interface web grâce
au menu "Import Mardown"