On peut écrire du texte formaté en Markdown dans différents logiciels ou plateformes, nous utiliserons principalement les notebook Basthon (Capytale), et les plateformes comme Hedge Docs.

Mise en forme générale du texte

Insérer une image

Pour insérer une image, le code de base est ![Texte alternatif](URL de l'image)

Le texte alternatif permet de fournir une indication en cas de lien cassé (le lien ne fonctionne plus), et il permet également aux personnes malvoyantes d'avoir une descrption de l'image affichée. L'URL d'une image ressemble à cela :

https://nsi.rocks/img/logo.png

Les extensions les plus courantes pour les images sont .png, .jpg, .svg, .gif.

Les listes

On peut réaliser des listes non ordonnées :

item
item
item
item
item

On peut également réaliser des listes ordonnées :

item 1
item 2
item 3

Les titres

Pour insérer un titre, il faut précéder le texte d'un dièse # :

Titre 1
Titre 2
Titre 3

Insérer du code

Il est possible d'insérer des lignes de code, les indentations et l'organisation du code seront alors respectés. La plupart du temps, vous pouvez ajouter le nom du langage juste après les "backticks" pour obtenir une coloration syntaxique.

Ceci est une fonction en Python
def addition(a, b):
    return a+b