#Memo Syntaxe Markdown Github
Projet d'écriture : Syntaxe Markdown Versus HTML
Projet d'écriture : [Syntaxe Markdown Versus HTML](rep/syntaxe.md/ "En cours d'écriture")
##TODO
- Page à compléter
- Memo
- Ajouter les fonctionnalités supplémentaires Markdown de Github
- Étiquettes de liens
- Intégrer lien vers Easy TOC creation by ekalinin
##Table des matières
- Introduction
- Les titres
- Les Sauts de ligne et ligne horizontale
- Les citations
- Les listes
- Les blocs de texte et code dans le texte
- Emphase du texte et caractère d'échappement
- Les liens
- Aérer le texte
John Gruber a créé le langage Markdown est 2004, avec la participation significative de Aaron Swartz pour la syntaxe. Ce langage permet d'écrire et de lire aisément dans un format en texte plein, sans être distrait par les balises de formatage. De plus, il accepte toute balise HTML. Sa forme est très proche de la syntaxe wiki comme celle de Dokuwiki et il est donc facile de passer de l'un à l'autre. En fait, cet espace de test est pour moi l'occasion d'apprendre à utiliser les commandes Git et, en faisant d'une pierre deux coups, la syntaxe Markdown. Github a ajouté des fonctionnalités au langage Markdown qui seront détaillées à part ou signalées comme telles.
[TOC](#table-des-matières)
Titre de niveau 1
=================
Titre de niveau 2
-----------------
Il suffit de souligner avec plusieurs caractères == ou -- pour avoir un titre. Le nombre importe peu.
# Titre de niveau 1
## Titre de niveau 2
ou en entourant du même nombre de signes # le titre
### Titre de niveau 3 ###
#### Titre de niveau 4 ####
##### Titre de niveau 5 #####
##### Titre de niveau 6 #####
[TOC](#table-des-matières) ## Sauts de ligne et ligne horizontale ##
pour faire un saut de ligne, il suffit de finir une ligne par deux espaces puis de taper sur Entrée.
une ligne horizontale s'obtient avec au moins trois ***
et un bloc de citation avec un chevron en début de ligne
avec deux pour une réponse comme dans les courriels
donc, avec 1 ou de multiples > en début de ligne
> et un bloc de citation avec un chevron en début de ligne
>> avec deux pour une réponse comme dans les courriels
>>> donc, avec 1 ou de multiples chevrons en début de ligne
[TOC](#table-des-matières) ## Les listes ##
- premier point
- deuxième point
- sous-point
- deuxième sous-point
- troisième point
- quatrième point
Les listes non ordonnées s'obtiennent en démarrant la ligne avec le signe * ou + ou - au choix suivi d'au moins deux espaces. Pour faire des sous-listes, ajouter une tabulation ou plusieurs espaces.
- Les listes ordonnées s'obtiennent avec un nombre suivi d'un point "." suivi d'au moins deux espaces
- Les nombres utilisés n'ont pas d'importance
- pour la sortie HTML
- n'importe quel chiffre sera traduit en rapport de sa position dans la liste, 1 s'il est en premier, 3 s'il est en troisième position, et non par sa valeur en tant que nombre. Vous pouvez commencer votre liste avec 1099 si cela vous chante, il sera traduit en 1. Cette liste est créée pour le test avec dans l'ordre 1, puis 108 puis 99 puis 4.
- Liste 10. sous liste 12. détail sous-liste 1. encore plus détaillé 2. et retour au premier niveau
- retour à la liste
- s'obtient en ajoutant au moins trois espaces ou une tabulation. Le formatage liste sous-liste...(1., i., a.) est déjà défini.
##Les blocs de texte et code dans le texte ##
4 indentations (4 espaces ou une tabulation) en début de ligne créent un bloc de texte.
avec la possibilité d'ajouter une indentation dans le bloc en ajoutant une tabulation ou 4 espaces.
Pour sortir d'un bloc, il faut une ligne sans indentation
Sorti du bloc.
L'intérêt des blocs est que la syntaxe Markdown et n'importe quel code ne sont pas interprétés. Il est également possible d'entourer une étendue de code à l'intérieur d'un paragraphe.
Un exemple : Pour regrouper dans un seul répertoire des fichiers flac répartis dans des sous répertoires, utilisez la commande
find -type f -name "*.flac" -exec cp {} ~/mon_repertoire_destination/ \;et vous aurez tous vos fichiers flac copiés dans ce nouveau répertoire.
Il suffit d'entourer votre commande avec un guillemet oblique` Alt Gr + 7
[TOC](#table-des-matières) ## Caractère d'échappement et emphase du texte ##
La barre oblique inverse \ permet d'échapper des caractères qui seraient interprétés autrement comme du langage Markdown. Pour avoir littéralement ces caractères :
\ ` * _ {} [] () # + - . !
on utilisera la barre oblique inverse \ devant.
Italique
*Italique*
_Italique_
Gras
**Gras**
__Gras__
~~ texte barré ~~
~~barré~~ (uniquement sur Github)
[TOC](#table-des-matières)
Les liens font référence à des ressources internes ou externes. Pour les liens internes faisant référence à une ressource locale sur le serveur, il est possible d'utiliser une adresse relative, que ce soit pour un lien de page ou d'image. Il est également possible d'affecter une étiquette à un lien et de l'appeler n'importe où dans la page (comme une ancre ou note de bas de page ?).
###Liens internes ###
Voir mon projet de page [Syntaxe Markdown Versus HTML](rep/syntaxe.md/ "En cours d'écriture")
pour une page locale dans le répertoire "rep" avec une description au survol de la souris donnera :
Voir mon projet de page Syntaxe Markdown Versus HTML
affichera l'image Markdown.png se trouvant dans le répertoire image comme en haut de page.
Le lien est entre crochets et l'adresse est entre parenthèses avec une description possible entre guillemets.
Pour les images, il faut ajouter ! un point d'exclamation devant.
Faire un lien vers une section d'un document en utilisant les titres
[TOC](#table-des-matières)
Pour aller sur le site de Dokuwiki
Pour aller sur le site de [Dokuwiki](https://dokuwiki.org "Un wiki cool")
Pour afficher une image externe
![image travaux](https://upload.wikimedia.org/wikipedia/commons/a/ab/Warning_icon.png"Travaux en cours")
le langage Markdown ne permet pas de spécifier une taille d'image ou son emplacement par rapport au texte. En cas de besoin, il faudra utiliser une balise HTML.
[TOC](#table-des-matières)
<p> </p>
Cette balise permet d'aérer le texte.