Comment écrire avec Markdown

écrit par Marie

Last updated on: décembre 30, 2016

MarkDown Logo

Markdown, c’est quoi ?

Markdown est une façon d’écrire qui permet à tous d’écrire du HTML sans même s’en rendre compte. Créé en 2004 par John Gruber, ce dernier souhaitait offrir aux non-programmeurs un moyen d’écrire du texte facile à lire qui serait traduit en HTML.

Quelle utilité ?

Le but de Markdown est de pouvoir mettre en forme facilement et efficacement du texte en utilisant uniquement le clavier. C’est facile, rapide et à la portée de tous. Écrire de cette façon est bien utile sur certains forums comme Stack Overflow, Reddit, Github, ou encore pour rédiger des articles avec Jekyll! WordPress permet aussi de rédiger avec un peu de Markdown depuis la version 4.3.

Markdown in WordPress

MarkDown sur WordPress

Vous pouvez aussi créer et modifier des fichiers .md ou .markdown, qui sont l’extension propre aux fichiers écrits en markdown.

Tester le résultat

Il existe plusieurs sites pour tester vos connaissances en Markdown.

Comment ça fonctionne ?

Mise en forme

Italique

Je suis en *italique* 
Je suis en _italique_

Résultat: 
Je suis en italique

Gras

Je suis en **gras**
Je suis en __gras__

Résultat:
Je suis en gras

 

Les titres H1, H2…

Je suis un titre H1 
=========

Je suis un titre H2 
---------

# Titre H1
## Titre H2 
### Titre H3

Résultat: 

<h1>Je suis un titre H1</h1> 

<h2>Je suis un titre H2</h2>

 

Les listes

Non ordonnée

* Bonjour 
* Comment ça va ?
    * Bien
    * Mal 
    * Toutes ces réponses 
* Et toi ?

Ordonnée

1. Je suis le numéro un
2. Et je suis le suivant
3. Et encore !

 

Citations

> Girl Knows Tech
> Le meilleur blog techno

Se traduit en…

<blockquote>
<p>Girl Knows Tech</p>
<p>Le meilleur blog techno</p>
</blockquote>

ou

Girl Knows Tech

Le meilleur blog techno

 

Bouts de code

Une ligne

Comme sur slack ! Il suffit de faire un accent grave

`String girlKnowsTech = "Meilleur blog techno";`

Plusieurs lignes

Pour mettre des bouts de code, il faut simplement indenter chaque ligne de 4 espaces.

Liens hypertextes

Visitez tous les jours [Girl Knows Tech](https://girlknowstech.com) pour lire de nouveaux articles

Visitez tous les jours Girl Knows Tech pour lire de nouveaux articles

Images

![Texte Alternatif](Lien direct vers l'image)

C’est à peu près pareil que la structure pour faire un lien, sauf qu’il y a un point d’exclamation au début (!). Le texte entre crochets est l’attribut « alt » de l’image. Cette information est utilisée pour les aveugles ou lorsqu’un problème se produit et l’image ne peut être affichée.

Séparation

-------------


*************

Résultat: 


Vous devez écrire 3 ou 4 étoiles ou tirets minimum pour que ça fonctionne!

2 commentaires
0

Vous pourriez aimer

2 commentaires

Hegel Motokoua 6 août 2020 - 9:59

Merci Beaucoup pour cet article, ça m’a permit de détailler mon application sur github !

Reply
Marie 1 septembre 2020 - 9:37

Super, ça me fait plaisir!
Marie

Reply

Écrire un commentaire

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.