nodelab

Le markdown

Sur ce blog vous pouvez rédiger vos commentaires en Markdown. Mais qu'est-ce que le Markdown me direz-vous ! Hé bien il s'agit d'un langage de balisage créé par John Gruber et Aaron Swartz (lien Wikipédia). Il permet de simplifier la rédaction d'HTML, dans notre cas. Voici donc plusieurs exemples de son utilisation pour que vous puissiez rédiger de beaux commentaires.


Titre et sous-titre

Pour faire un titre, il suffit de précéder le titre d'un dièse et pour faire un sous-titre, il faut le précéder de 2 dièses. Voici un exemple :

# Un titre
## Un sous-titre

Et voici le résultat :

Un titre

Un sous-titre


Mettre en italique

Pour mettre du texte en italique, vous avez deux possibilités, dans les deux cas il faudra entourer le texte que vous voulez mettre en italique par un caractère. Ce caractère peut être soit une étoire (*), soit un underscore(_), comme ceci :

*texte en italique* ou _texte en italique_

Ce qui donne le résultat suivant : texte en italique ou texte en italique


Mettre en gras

Pour le gras, c'est le même principe, il faut juste mettre deux étoiles (ou underscore) de chaque côté.

**texte en gras** ou __texte en gras__

Ce qui donne le résultat suivant : texte en gras ou texte en gras


Ajouter un lien

Mettre un lien est peut être très pratique. Entre crochet il faut mettre le texte à afficher et entre parenthèse le lien (ne pas oublier le http:// devant) :

[Asylamba, jeu de stratégie en ligne](http://asylamba.com)

Et le lien apparait : Asylamba, jeu de stratégie en ligne


Ajouter une image

Pour une image c'est le même principe, il faut juste ajouter un point d'exclamation au début :

![un chat](http://asylamba.com/public/media/files/formated/cool-cat.jpg)

un chat


Faire des listes

Markdown nous permet également de faire des listes. On peut faire des listes à puces ou des listes numérotées. Pour les listes à puces, il faut précéder chaque entrée par une étoile et pour une liste numérotée, il faut la précéder d'un chiffre suivi.

* premier élément d'une liste à puce
* deuxième élément d'une liste à puce
* troisième élément d'une liste à puce

1 premier élément d'une liste numérotée
2 deuxième élément d'une liste numérotée
3 troisième élément d'une liste numérotée

Et voici le résultat :

  • premier élément d'une liste à puce
  • deuxième élément d'une liste à puce
  • troisième élément d'une liste à puce

Et avec les numéros :

  1. premier élément d'une liste numérotée
  2. deuxième élément d'une liste numérotée
  3. troisième élément d'une liste numérotée

Inclure du code

Pour insérer du code dans le texte, il faut entourer le mot (ou les mots) d'un accent grave. Voici un code dans un texte. Tandis que si vous voulez ajouter un bout de code, il faut écrire trois accents graves suivis du nom du langage. Vous écrivez ensuite le code. Et il faut refermer ensuite avec trois accents graves à nouveau.

'''java
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello World!");
    }
}
'''

(* remplacer les ' par des `)

Ce qui nous donne :

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello World!");
    }
}

(avec la coloration syntaxique, s'il vous plaît)

Différents langages sont disponibles. Il y a markup qui sert à coloriser différents langages de balisage comme du HTML ou du XML, css pour du CSS, php pour du PHP, sql pour du SQL, javascript pour du Javascript, c pour du C, cpp pour du C++, java pour du Java et python pour du Python.

Avec ça il y a déjà de quoi faire ! A plus.

0 commentaire

Aucun commentaire n'a été posté.

Poster un commentaire