Anti-sèche markdown

- 1900 mots

Facile à comprendre, non ?

Après plus d’un an passé sur la syntaxe Mediawiki, j’ai décidé de passer l’année 2014 en Markdown. Cette anti-sèche est une première ébauche de traduction/adaptation en français de la « Markdown CheatSheet » d’Adam Pritchard.

Cette traduction est purement destinée à des fins d’étude personnelle et de référence rapide pour étude d’inter-opérabilité de ce langage de mise en forme entre différentes motorisations. (Un langage pressenti comme l’avenir de l’écriture)

Pour une information de référence plus complète, regardez la spécification originale de John Gruber et la page d’information sur le Markdown-enrichi de GitHub.

P.S. Considérez ce post comme un premier essai personnel non mis à jour. Publié initialement à partir de l’éditeur de texte Byword assorti de son module intégré de publication vers WordPress. Le source est sujet à modification : cette anti-sèche publiée en syntaxe Markdown peut être directement modifiée et améliorée ici sur GitHub.

Table des matières

Titres

pas de titres
# H1
## H2
### H3
#### H4
##### H5
###### H6

Alternativement, pour H1 et H2, un style souligné :

Alt-H1
======

Alt-H2
------

H1

H2

H3

H4

H5
H6

Alternativement, pour H1 et H2, un style souligné :

Alt-H1

Alt-H2

Emphase

L'emphase, ou italique, avec *astérisques* ou _soulignés_.

Une emphase forte, ou gras avec **astérisques** ou __soulignés__.

Emphase combinée avec **astérisques et _soulignés_**.

Barré en utilisant deux tildes. ~~Effacez-ça.~~

L’emphase, ou italique, avec astérisques ou soulignés.

Une emphase forte, ou gras avec astérisques ou soulignés.

Emphase combinée avec astérisques et soulignés.

Barré en utilisant deux tildes. Effacez-ça.

Listes

(Dans cet exemple, les espaces avant et après sont présentés avec des points : ⋅)

1. Premier item de liste ordonnée
2. Un autre item
⋅⋅* une sous-liste ordonnée. 
1. Les véritables numéros n'importent pas, si ce n'est que c'est un nombre
⋅⋅1. Sous-liste ordonnée
4. Un autre item.

⋅⋅⋅Vous pouvez avoir proprement indenté les paragraphes dans des items de listes. Remarquez l'espace-blanc au-dessus, et les espaces en tête (au moins un, mais nous en utiliserons trois pour aligner aussi le Markdown brut).

⋅⋅⋅Pour avoir un retour ligne sans paragraphe, vous devrez utiliser deux espaces consécutifs⋅⋅
⋅⋅⋅Remarquez que cette ligne est séparée, mais dans le même paragraphe.⋅⋅
⋅⋅⋅(Ceci est contraire au saut de ligne typique GFM, où les espaces après ne sont pas requis.)

* Une liste non ordonnée peut utiliser des astérisques
- Ou des moins
+ Ou des plus
  1. Premier item de liste ordonnée
  2. Un autre item
    • une sous-liste ordonnée.
  3. Les véritables numéros n’importent pas, si ce n’est que c’est un nombre
    1. Sous-liste ordonnée
  4. Un autre item.

Vous pouvez avoir proprement indenté les paragraphes dans des items de listes. Notez la ligne blanche au-dessus, et les espaces avant, (au moins un, mais nous en utiliserons trois ici pour aligner aussi le Markdown brut).

Pour avoir un retour ligne sans paragraphe, vous devrez utiliser deux espaces consécutifs.
Remarquez que cette ligne est séparée, mais dans le même paragraphe.
(Ceci est contraire au saut de ligne typique GFM, où les espaces après ne sont pas requis.)

  • Une liste non ordonnée peut utiliser des astérisques
  • Ou des moins
  • Ou des plus

Liens

Il y a deux moyens pour créer des liens.

[Je suis un lien dans la ligne](https://www.google.com)

[Je suis un lien avec un style dans la ligne et avec un titre](https://www.google.com "Page d'accueil de Google")

[Je suis un lien avec un style de référence][texte de référence Arbitraire insensible à la casse]

[Je suis une référence relative vers un fichier de dépôt](../blob/master/LICENCE)

[Vous pouvez utiliser des nombres pour un lien de définitions en style-référence][1]

Ou le laisser vide et utiliser le [lien texte lui-même]

Un peu de texte pour montrer que la référence de liens peut suivre plus tard.

[texte de référence arbitraire insensible à la casse]: https://www.mozilla.org
[1]: http://slashdot.org
[lien texte lui-même] : http://www.reddit.com

Je suis un lien dans la ligne

Je suis un lien avec un style dans la ligne et avec un titre

Je suis un lien avec un style de référence

Je suis une référence relative vers un fichier de dépôt

Vous pouvez utiliser des nombres pour un lien de définitions en style-référence

Ou le laisser vide et utiliser le [lien texte lui-même]

Un peu de texte pour montrer que la référence de liens peut suivre plus tard.

[lien texte lui-même] : http://www.reddit.com

Images

Voici un logo (survolez-le pour voir le texte du titre) : 

Style dans-la-ligne : 
![texte alt](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Titre Texte 1")

Référence-style : 
![texte alt][logo]

[logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Titre Texte 2"

Voici un logo (survolez-le pour voir le texte du titre) :

Style dans-la-ligne : texte alt

Référence-style : texte alt

Coloration Syntaxique

Les blocs de code font partie de la spécification Markdown, mais pas la coloration syntaxique. Néanmoins beaucoup d’analyseurs – comme celui de Github et Markdown Here – supportent la mise en valeur de syntaxe. Markdown Here supporte la mise en valeur de dizaines de langages (et pas -vraiment- des langages, commes les diffs et headers HTTP) ; pour voir la liste complète, et savoir comment écrire le nom des langages, regardez la page de démo highlight.js.

Le `code` dans la ligne a des `guillemets arrière autour` de lui.

Le code dans la ligne a des guillemets arrière autour de lui.

Les blocs de code sont soit entourés avec trois guillemets-arrière ```, ou sont indentés avec quatre espaces. Je recommande de n’utiliser que les blocs de code entourés de guillemets arrière— ils sont plus aisés et sont les seuls à supporter la mise en valeur de la syntaxe.

 javascript
 var s = "Mise en valeur de la syntaxe JavaScript";
 alert(s);

python
 s = "Mise en valeur de la syntaxe Python"
 print s

Aucun langage indiqué, aussi pas de mise en valeur de la syntaxe. 
Mais jetons un <b>tag</b>.

var s = "Mise en valeur de la syntaxe JavaScript";
alert(s);

s = "Mise en valeur de la syntaxe Python"
print s

Aucun langage indiqué, aussi pas de mise en valeur de la syntaxe. Mais jetons un tag.

(La motorisation Hugo est livrée nativement avec la mise en valeur de syntaxe. La mise en valeur peut aussi s’essayer dans un e-mail Markdown here ou un README Github Markdown ou un problème Github – vous pouvez pré-visualiser un nouveau problème sans le soumettre.)

De nouveau, pour voir quels sont les langages disponibles pour la mise en valeur/couleur, et savoir comment écrire ces noms de langage, regardez la page de démo highlight.js.

Tableaux

Les tableaux ne font pas partie du coeur de la spécification Markdown, mais ils font partie du Markdown enrichi sur GitHub et Markdown Here les supporte. Ils constituent un moyen facile pour ajouter des tableaux dans votre e-mail — une tâche qui autrement requiert de copier-coller à partir d’une autre application.

Les signes deux points peuvent être utilisés pour aligner les colonnes.

| Les Tableaux           | Sont            | Cools    |
| -------------          |:-------------:  | -----:  |
| col 3 est              | alignée à droite| $1600    |
| col 2 est              | centrée         |  $12     |
| les rayures de zèbres  | sont géniales   |  $1    |

Il doit y avoir au moins 3 tirets séparant chaque cellule d’en-tête. Les signes pipes (|) sont facultatifs, et vous n’avez pas besoin d’aligner proprement les lignes brutes Markdown. Vous pouvez aussi utiliser le Markdown dans la ligne.

markdown
Markdown | Moins | Joli
--- | --- | ---
*s'aligne* | `encore` | **joliment**
1 | 2 | 3

Les signes deux points : peuvent être utilisés pour aligner des colonnes.

Les Tableaux Sont Cools
la col 3 est aligné à droite $1600
la col 2 est centrée $12
les lignes de zèbre sont jolies $1

Il doit y avoir au moins 3 tirets séparant chaque cellule d’en-tête. Les pipes (|) à l’extérieur sont facultatifs et vous n’avez pas besoin de produire la ligne brute de Markdown. Vous pouvez également utiliser le Markdown dans la ligne.

Markdown | Moins | Joli | Still |renders| nicely

1 | 2 | 3

Citations

markdown
> Les citations sont très pratiques dans l'email pour émuler le texte de réponse.
> Cette ligne fait partie de la même citation.

Fin de citation.

> Ceci est volontairement une très longue ligne qui sera citée proprement quand elle sera emballlée. Oh mec, continuons à écrire comme ça pour nous assurer que ce sera suffisamment long pour être bien emballé pour tout le monde. Bien sûr, vous pouvez *placer* du **Markdown** dans un bloc de citation.

Les citations sont très pratiques dans l’email pour émuler le texte de réponse. Cette ligne fait partie de la même citation.

Fin de citation.

Ceci est volontairement une très longue ligne qui sera citée proprement quand elle sera emballlée. Oh, continuons à écrire comme ça pour nous assurer que ce sera suffisamment long pour être bien emballé pour tout le monde. Bien sûr, vous pouvez placer du Markdown dans un bloc de citation.

HTML dans ligne

Vous pouvez aussi utiliser du HTML brut dans votre Markdown, et il fonctionnera presque tout aussi bien.

<dl>
  	<dt>Liste de définitions</dt>
  	<dd>C'est quelque chose que les personnes peuvent utiliser de temps en temps.</dd>
	
  	<dt>Markdown dans le HTML</dt>
  	<dd>Ne fonctionne *pas* **très** bien. Utilisez les <em>tags</em> HTML.</dd>
</dl>
Liste de définitions
C'est quelque chose que les personnes peuvent utiliser de temps en temps.
Markdown dans le HTML
Ne fonctionne *pas* **très** bien. Utilisez les tags HTML.

Règle horizontale

Trois ou plus...

---

Traits d'union 

***

Astérisques

___

Soulignés

Trois ou plus…

Traits d’union

Astérisques

Soulignés

Sauts de lignes

Ma recommandation basique pour savoir comment fonctionne le saut de ligne est d’expérimenter et découvrir – pressez une fois la touche <Entrée> (c’est à dire, insérer une nouvelle ligne), puis appuyez deux fois (c’est à dire, insérer deux lignes), et regardez ce qui se passe. Vous apprendrez bientôt à avoir ce que vous désirez. « Markdown Toggle » est votre ami.

Voici quelques petits trucs à essayer :

	Voici une ligne pour démarrer.

	Cette ligne est séparée de celle du dessus par deux nouvelles lignes, aussi ce sera un *paragraphe séparé*. 

	Cette ligne est aussi un paragraphe séparé, mais...
	Cette ligne n'est séparée que par une seule nouvelle ligne, aussi c'est une ligne séparée dans le *même paragraphe*.

Voici une ligne pour démarrer.

Cette ligne est séparée de celle du dessus par deux nouvelles lignes, aussi ce sera un paragraphe séparé.

Cette ligne est aussi un paragraphe séparé, mais… Cette ligne n’est séparée que par une seule nouvelle ligne, aussi c’est une ligne séparée dans le même paragraphe.

(Note technique : Markdown Here utilise les sauts de ligne GFM, par conséquent il n’y a pas besoin d’utiliser les deux espaces de saut de ligne de MD.)

Vidéos Youtube

Elles ne peuvent pas être ajoutées directement, mais vous pouvez ajouter une image avec un lien vers la vidéo comme suit :

<a href="http://www.youtube.com/watch?feature=player_embedded&v=YOUTUBE_VIDEO_ID_ICI
" target="_blank"><img src="http://img.youtube.com/vi/YOUTUBE_VIDEO_ID_ICI/0.jpg" 
alt='TEXTE ALT IMAGE ICI' width='240' height='180' border='10' /></a>

Ou, en pur Markdown, mais en perdant la taille et la bordure de l’image :

[![TEXTE ALT IMAGE ICI](http://img.youtube.com/vi/YOUTUBE_VIDEO_ID_HERE/0.jpg)](http://www.youtube.com/watch?v=YOUTUBE_VIDEO_ID_ICI)
“Anti-sèche markdown” a été mise à jour le :
Améliorez cette page