summaryrefslogtreecommitdiffhomepage
path: root/fr-fr/markdown-fr.html.markdown
blob: 2955fd14d912710dabe484340d26e8a1ed5c103c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
---
language: markdown
contributors:
- ["Andrei Curelaru", "http://www.infinidad.fr"]
filename: markdown-fr.md
lang: fr-fr
---


Markdown a été créé par John Gruber en 2004. Il se veut être d'une syntaxe
facile à lire et à écrire, aisément convertible en HTML (et dans beaucoup
d'autres formats aussi).

Les implémentations du Markdown varient d'un analyseur syntaxique à un autre.
Ce guide va essayer de clarifier quand une fonctionnalité est universelle ou
quand elle est specifique à un certain analyseur syntaxique.

- [Balises HTML](#balises-html)
- [En-têtes](#en-tetes)
- [Styles de texte basiques](#style-de-text-basiques)
- [Paragraphes](#paragraphes)
- [Listes](#listes)
- [Blocs de code](#blocs-de-code)
- [Séparateur horizontal](#separateur-horizontal)
- [Liens hypertextes](#liens-hypertextes)
- [Images](#images)
- [Divers](#divers)

## Balises HTML

Markdown est un sur-ensemble du HTML, donc tout fichier HTML est un ficher
Markdown valide.

```md
<!-- Ce qui veut dire que vous pouvez utiliser des balises HTML dans un fichier
Markdown, comme la balise commentaire dans laquelle nous sommes à présent, car
celle-ci ne sera pas affectée par l'analyseur syntaxique du Markdown.
Toutefois, si vous voulez créer une balise HTML dans un fichier Markdown,
vous ne pourrez pas utiliser du Markdown à l'intérieur de cette derniere. -->
```

## En-têtes

Vous pouvez facilement créer des balises HTML `<h1>` à `<h6>` en précédant le
texte de votre futur titre par un ou plusieurs dièses ( # ), de un à six, selon
le niveau de titre souhaité.

```md
# Ceci est un <h1>
## Ceci est un <h2>
### Ceci est un <h3>
#### Ceci est un <h4>
##### Ceci est un <h5>
###### Ceci est un <h6>
```

Markdown fournit également une façon alternative de marquer les h1 et h2.

```md
Ceci est un h1
=============

Ceci est un h2
-------------
```

## Styles de texte basiques

On peut facilement rendre un texte "gras" ou "italique" en Markdown.

```md
*Ce texte est en italique.*
_Celui-ci aussi._

**Ce texte est en gras.**
__Celui-là aussi.__

***Ce texte a les deux styles.***
**_Pareil ici_**
*__Et là!__*
```

Dans le "GitHub Flavored Markdown", utilisé pour interpréter le Markdown sur
GitHub, on a également le texte barré.

```md
~~Ce texte est barré.~~
```

## Paragraphes

Les paragraphes sont représentés par une ou plusieurs lignes de texte séparées
par une ou plusieurs lignes vides.

```md
Ceci est un paragraphe. Là, je suis dans un paragraphe, facile non?

Maintenant je suis dans le paragraphe 2.
Je suis toujours dans le paragraphe 2!


Puis là, eh oui, le paragraphe 3!
```

Si jamais vous souhaitez insérer une balise HTML `<br />`, vous pouvez ajouter
un ou plusieurs espaces à la fin de votre paragraphe, et en commencer un
nouveau.

```md
J'ai deux espaces vides à la fin (sélectionnez moi pour les voir).

Bigre, il y a un <br /> au dessus de moi!
```

Les blocs de citations sont générés aisément, grâce au caractère >.

```md
> Ceci est une superbe citation. Vous pouvez même
> revenir à la ligne quand ça vous chante, et placer un `>`
> devant chaque bout de ligne faisant partie
> de la citation.
> La taille ne compte pas^^ tant que chaque ligne commence par un `>`.

> Vous pouvez aussi utiliser plus d'un niveau
>> d'imbrication!
> Classe et facile, pas vrai?
```

## Listes

Les listes non ordonnées sont marquées par des asterisques, signes plus ou
signes moins.

```md
* Item
* Item
* Un autre item
```

ou

```md
+ Item
+ Item
+ Encore un item
```

ou

```md
- Item
- Item
- Un dernier item
```

Les listes ordonnées sont générées via un nombre suivi d'un point.

```md
1. Item un
2. Item deux
3. Item trois
```

Vous pouvez même vous passer de tout numéroter, et Markdown générera les bons
chiffres. Ceci dit, cette variante perd en clarté.

```md
1. Item un
1. Item deux
1. Item trois
```

(Cette liste sera interprétée de la même façon que celle au dessus)

Vous pouvez également utiliser des sous-listes.

```md
1. Item un
2. Item deux
3. Item trois
* Sub-item
* Sub-item
4. Item quatre
```

Il y a même des listes de taches. Elles génèrent des champs HTML de type case à
cocher.

```md
Les [ ] ci-dessous, n'ayant pas de [ x ], deviendront des cases à cocher HTML
non-cochées.
- [ ] Première tache à réaliser.
- [ ] Une autre chose à faire.
La case suivante sera une case à cocher HTML cochée.
- [x] Ça ... c'est fait!
```

## Blocs de code

Pour marquer du texte comme étant du code (qui utilise la balise `<code>`), il
suffit d'indenter chaque ligne avec 4 espaces ou une tabulation.

```md
    echo "Ça, c'est du Code!";
    var Ça = "aussi !";
```

L'indentation par tabulation (ou série de quatre espaces) fonctionne aussi à
l'intérieur du bloc de code.

```md
    my_array.each do |item|
       puts item
    end
```

Des bouts de code en mode en ligne s'ajoutent en utilisant le caractères
`` ` ``.

```md
La fonction `run()` ne vous oblige pas à aller courir!
```

En "GitHub Flavored Markdown", vous pouvez utiliser des syntaxes spécifiques
selon le language.

<pre>
<code class="highlight">&#x60;&#x60;&#x60;ruby
def foobar
    puts "Hello world!"
end
&#x60;&#x60;&#x60;</code>
</pre>

Pas besoin d'indentation pour le code juste au dessus, de plus, GitHub va
utiliser une coloration syntaxique pour le langage indiqué après les \`\`\`.

## Séparateur horizontal

La balise `<hr/>` peut être aisement ajoutée en utilisant trois ou plus
astérisques ou tirets, avec ou sans espaces entre chacun.

```md
***
---
- - -
****************
```

## Liens hypertextes

Une des fonctionnalités sympathiques du Markdown est la facilité d'ajouter des
liens hypertextes. Le texte du lien entre crochet `` [] ``, l'url entre
parenthèses `` () ``, et voilà le travail.

```md
[Clic moi!](http://test.com/)
```

Pour ajouter un attribut titre, ajoutez le entre les parenthèses entre
guillemets apres le lien.

```md
[Clic moi!](http://test.com/ "Lien vers Test.com")
```

Markdown supporte aussi les liens relatifs.

```md
[En avant la musique](/music/).
```

Les liens de références sont eux aussi disponibles en Markdown.

```md
[Cliquez ici][link1] pour plus d'information!
[Regardez aussi par ici][foobar] si vous voulez.

[link1]: http://test.com/ "Cool!"
[foobar]: http://foobar.biz/ "Génial!"
```

Le titre peut aussi être entouré de guillemets simples, ou de parenthèses, ou
absent. Les références peuvent être placées où vous voulez dans le document et
les identifiants peuvent être n'importe quoi tant qu'ils sont uniques.

Il y a également le nommage implicite qui transforme le texte du lien en
identifiant.

```md
[Ceci][] est un lien.

[ceci]: http://ceciestunlien.com/
```

Mais ce n'est pas beaucoup utilisé.

## Images

Pour les images, la syntaxe est identique à celle des liens, sauf que précédée
d'un point d'exclamation!

```md
![Attribut ALT de l'image](http://imgur.com/monimage.jpg "Titre optionnel")
```

Là aussi, on peut utiliser les références.

```md
![Ceci est l'attribut ALT de l'image][monimage]

[monimage]: relative/urls/cool/image.jpg "si vous voulez un titre, c'est ici."
```

## Divers

### Liens hypertextes automatiques

```md
<http://testwebsite.com/> est équivalent à :
[http://testwebsite.com/](http://testwebsite.com/)
```

### Liens hypertextes automatiques pour emails

```md
<foo@bar.com>
```

### Caracteres d'echappement

Il suffit de précéder les caractères spécifiques à ignorer par des backslash \

```md
Pour taper *ce texte* entouré d'astérisques mais pas en italique :
Tapez \*ce texte\*.
```

### Touches de clavier

Avec le "Github Flavored Markdown", vous pouvez utiliser la balise `<kdb>`
pour représenter une touche du clavier.

```md
Ton ordinateur a planté? Essayer de taper :
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
```

### Tableaux

Les tableaux ne sont disponibles que dans le "GitHub Flavored Markdown" et
ne sont pas tres agréable d'utilisation. Mais si vous en avez besoin :

```md
| Col1 | Col2 | Col3 |
| :----------- | :------: | ------------: |
| Alignement Gauche | Centé | Alignement Droite |
| bla | bla | bla |
```

ou bien, pour un résultat équivalent :

```md
Col 1 | Col2 | Col3
:-- | :-: | --:
Ough que c'est moche | svp | arrêtez
```

Pour plus d'information, consultez le post officiel de Jhon Gruber à propos de
la syntaxe [ici](http://daringfireball.net/projects/markdown/syntax) et la
superbe fiche pense-bête de Adam Pritchard [là](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).