1ereNSI/markdown/.ipynb_checkpoints/MARKDOWN-checkpoint.ipynb

Guide d'utilisation Markdown

Introduction

Markdown est un langage de balisage simple créé en 2004 par John Gruber avec l'aide d'Aaron Swartz.

En informatique, les langages de balisage représentent une classe de langages spécialisés dans l'enrichissement d'information textuelle. L'inclusion de balises permet de transférer à la fois le contenu et des indications sur la mise en forme (mise en italique, gras...).

Le HTML est un autre langage de balisage. Le Markdown est un langage plus simple à appréhender; son apprentissage facilitera celui de l'HTML.

Il a été créé dans le but d'offrir une syntaxe facile à lire et à écrire.

Un document balisé par Markdown peut être lu en l'état sans donner l’impression d'avoir été balisé ou formaté par des instructions particulières.

Usages

Le langage de balisage léger Markdown est utilisé dans de nombreuses applications, que ce soit dans des logiciels/éditeurs de code, des logiciels d'écriture, des plateformes de code, ou encore dans des chaînes d'édition avec l'addition d'autres logiciels. Les domaines concernés peuvent être le développement informatique, la rédaction de documentation technique ou encore la publication académique.

Certains sites comme discord permettent la gestion et l'affichage de texte au format Markdown.

La plupart des cours de NSI sont au format mardown, stocké sous la forme de fichier portant l'extension .md ou .ipynb.

Pour ouvrir, modifier ou visualiser les fichiers, il faut utiliser :

• markdown (.md), il faut utiliser le logiciel Typora ou le logiciel en ligne stackedit,
• notebook (.ipynb), il faut utiliser le logiciel en ligne Basthon

Formatage

L'emphase est l'exagération d’un mot ou d'une phrase en utilisant un style ou une fonte différente de celle du reste du texte — pour mettre l’accent dessus.

En markdown, l'emphase se manifeste par les caractères _ utilisés en paire.

Italique

Pour mettre une partie de texte en italique, il faut l'encadrer par un _.

Exemple : Cette partie du texte est en italique.

Est obtenu par la syntaxe :

Cette _partie du texte_ est en italique

Gras

Pour mettre une partie de texte en gras, il faut l'encadrer par un double __.

Exemple : Cette partie du texte est en gras.

Est obtenu par la syntaxe :

Cette __partie du texte__ est en gras`

Remarque

Il est possible de cumuler le formatage de texte.

Exemple : Cette partie du texte est en italique et en gras.

Est obtenu par la syntaxe constituée d'une paire de triples _

Cette ___partie du texte___ est en italique et en gras

Paragraphe et saut de ligne

Pour faire un nouveau paragraphe, sauter deux lignes, c'est à dire laisser une ligne vide entre les deux paragraphes. Sauter une seule ligne dans le texte d'origine n'aura aucun effet à l'affichage (l'affichage sera en continu).

Exemple :

Premier Paragraphe Deuxième Paragraphe

Est obtenu par la syntaxe suivante :

Premier Pragraphe
Deuxième Paragraphe

Exemple :

Premier Paragraphe

Deuxième Paragraphe

Est obtenu par la syntaxe suivante :

Premier Pragraphe

Deuxième Paragraphe

Citation

Il est possible de faire des citations, c'est-à-dire formater le texte dans un style particulier différent du reste du texte, en utilisant le symbole > en début de phrase. Le texte est mis avec espace et une barre verticale afin de symboliser la citation.

Exemple :

Moi, Monsieur, si j’avais un tel nez, il faudrait sur le champ que je l’amputasse !, Edmond Rostand / Cyrano de Bergerac

Est obtenu par la syntaxe suivantes :

> Moi, Monsieur, si j’avais un tel nez, il faudrait sur le champ que je l’amputasse !, Edmond Rostand / Cyrano de Bergerac

Citation sur plusieurs lignes

Il est possible de faire une citation sur plusieurs lignes. Dans ce cas, il faut utiliser le symbole > à chaque début de lignes constituant la citation.

Exemple :

Ah ! non ! c’est un peu court, jeune homme !

On pouvait dire… Oh ! Dieu ! … bien des choses en somme…

En variant le ton, – par exemple, tenez :

Agressif : « Moi, monsieur, si j’avais un tel nez,

Il faudrait sur-le-champ que je me l’amputasse ! »

Amical : « Mais il doit tremper dans votre tasse

Pour boire, faites-vous fabriquer un hanap ! »

Descriptif : « C’est un roc ! … c’est un pic ! … c’est un cap !

Que dis-je, c’est un cap ? … C’est une péninsule ! »

Curieux : « De quoi sert cette oblongue capsule ?

D’écritoire, monsieur, ou de boîte à ciseaux ? »

Gracieux : « Aimez-vous à ce point les oiseaux

Que paternellement vous vous préoccupâtes

De tendre ce perchoir à leurs petites pattes ? »

Truculent : « Ça, monsieur, lorsque vous pétunez,

La vapeur du tabac vous sort-elle du nez

Sans qu’un voisin ne crie au feu de cheminée ? »

Prévenant : « Gardez-vous, votre tête entraînée

Par ce poids, de tomber en avant sur le sol ! »

Tendre : « Faites-lui faire un petit parasol

De peur que sa couleur au soleil ne se fane ! »

Pédant : « L’animal seul, monsieur, qu’Aristophane

Appelle Hippocampéléphantocamélos

Dut avoir sous le front tant de chair sur tant d’os ! »

Cavalier : « Quoi, l’ami, ce croc est à la mode ?

Pour pendre son chapeau, c’est vraiment très commode ! »

Emphatique : « Aucun vent ne peut, nez magistral,

T’enrhumer tout entier, excepté le mistral ! »

Dramatique : « C’est la Mer Rouge quand il saigne ! »

Admiratif : « Pour un parfumeur, quelle enseigne ! »

Lyrique : « Est-ce une conque, êtes-vous un triton ? »

Naïf : « Ce monument, quand le visite-t-on ? »

Respectueux : « Souffrez, monsieur, qu’on vous salue,

C’est là ce qui s’appelle avoir pignon sur rue ! »

Campagnard : « Hé, ardé ! C’est-y un nez ? Nanain !

C’est queuqu’navet géant ou ben queuqu’melon nain ! »

Militaire : « Pointez contre cavalerie ! »

Pratique : « Voulez-vous le mettre en loterie ?

Assurément, monsieur, ce sera le gros lot ! »

Enfin parodiant Pyrame en un sanglot :

« Le voilà donc ce nez qui des traits de son maître

A détruit l’harmonie ! Il en rougit, le traître ! »

– Voilà ce qu’à peu près, mon cher, vous m’auriez dit

Si vous aviez un peu de lettres et d’esprit

Mais d’esprit, ô le plus lamentable des êtres,

Vous n’en eûtes jamais un atome, et de lettres

Vous n’avez que les trois qui forment le mot : sot !

Eussiez-vous eu, d’ailleurs, l’invention qu’il faut

Pour pouvoir là, devant ces nobles galeries,

me servir toutes ces folles plaisanteries,

Que vous n’en eussiez pas articulé le quart

De la moitié du commencement d’une, car

Je me les sers moi-même, avec assez de verve,

Mais je ne permets pas qu’un autre me les serve.

Listes

Sauter une ligne avant le début de la liste.

Liste non ordonnée

Pour créer une liste non ordonnée, il faut utiliser le symbole - pour chaque élément.

Exemple : Listes des fruits :

• Pommes
• Poires
• Raisin

Est obtenu par la syntaxe suivantes :

Listes des fruits :

- Pommes
- Poires
- Raisin

N.B : Une ligne vide doit précéder la liste et un espace est nécessaire entre le symbole - et l'élément de la liste.

Remarque

Il est possible d'imbriquer des listes. Pour cela, un espace est nécessaire entre l'élément parent et la liste imbriquée.

Exemple : Listes des fruits :

• Pommes
• Golden
• Gala
• Pink Lady
• ...
• Poires
• Raisin
• Corinthe noir
• Muscat d'Alexandrie

Est obtenu par la syntaxe suivantes :

Listes des fruits :

- Pommes
 - Golden
 - Gala
 - Pink Lady
 - ...
- Poires
- Raisin
 - Corinthe noir
 - Muscat d'Alexandrie

Liste ordonnée

Pour créer une liste ordonnée, il faut énumérer chaque élément précédé de son rang, d'un point et d'un espace.

Exemple : Liste ordonnée :

1. premier élément
2. deuxième élément
3. troisième élément

Est obtenu par la syntaxe suivantes :

Liste ordonnée :

1. premier élément
2. deuxième élément
3. troisième élément

Remarque 1

La valeur du rang ne doit pas nécessairement être indiqué. C'est le fait que chaque élément se suive qui constitue la liste ordonnée.

Exemple : Liste ordonnée :

1. premier élément
2. deuxième élément
3. troisième élément

Est obtenu par la syntaxe suivante :

Liste ordonnée :

1. premier élément
1. deuxième élément
1. troisième élément

Remarque 2

Comme pour les listes non ordonnées, il est possible d'imbriquer des listes ordonnées. Pour cela, un espace est nécessaire entre l'élément parent et la liste imbriquée.

Exemple : Liste ordonnée imbriquée:

1. premier élément
2. premier sous élément
3. deuxième sous élément
4. deuxième élément
5. troisième élément
6. premier sous élément

Est obtenu par la syntaxe suivante :

Liste ordonnée imbriquée:

1. premier élément
 1. premier sous élément
 2. deuxième sous élément
2. deuxième élément
3. troisième élément
 1. premier sous élément

Liste de cases à cocher

Pour créer une liste de cases à cocher, il faut énumérer chaque élément précédé par [ ] pour une case non cochée et [x] pour une case cochée.

Exemple : Le langage Markdown a été créé par :

• John Gruber
• Guido van Rossum
• Aaron Swartz
• Bill Gates

Est obtenu par la syntaxe suivante :

Le langage Markdown a été créé par :

- [x] John Gruber
- [ ] Guido van Rossum
- [x] Aaron Swartz
- [ ] Bill Gates

N.B : Le texte entre crochets doit comporter un seul et un seul caractère. Soit un espace pour une case non cochée, soit un x pour une case cochée.

Titres

Les titres sont créés avec un certain nombre de #(croisillons) avant le titre, qui correspondent au niveau de titre souhaité (de 1 à 6).

Exemple :

un titre de premier niveau

un titre de quatrième niveau

Est obtenu par la syntaxe suivante :

# un titre de premier niveau
#### un titre de quatrième niveau

Tableaux

Un tableau en Markdown est constitué de 3 éléments :

1. une ligne d'en-tête
2. une ligne de séparation
3. un ensemble de lignes de corps du tableau

Exemple :

Titre 1	Titre 2	Titre 3
Colonne	Colonne	Colonne
Alignée à	Alignée au	Alignée à
Gauche	Centre	Droite

Est obtenu par la syntaxe suivante :

| Titre 1       |     Titre 2     |        Titre 3 |
| :-- | :--: | --: |
| Colonne       |     Colonne     |        Colonne |
| Alignée à     |   Alignée au    |      Alignée à |
| Gauche        |     Centre      |         Droite |

En-tête

L'en-tête contient chaque titre de colonnes, séparés par un symbole |. Le titre sera automatiquement mis en gras.

Séparation

La ligne de séparation permet de délimiter l'en-tête du corps du tableau et de définir l'alignement du texte du contenu de la colonne.

• :--: indique que le contenu est aligné à gauche de la colonne,
• :--:: indique que le contenu est centré,
• --:: indique que le contenu est aligné à droite de la colonne.

Corps

Chaque ligne du corps du tableau contient le contenu de chaque colonne séparé par un symbole |. La couleur du fond de chaque ligne du tableau est alternée automatiquement.

Liens

Pour créer des liens de type url cliquable, il faut utiliser la syntaxe [texte du lien](url_du_lien).

Exemple : Site du lycée Masséna

Est obtenu par la syntaxe :

[Site du lycée Masséna](http://www.lycee-massena.fr/)

N.B : il n'y a pas d'espace entre le crochet fermant et la parenthèse ouvrante. Il faut écrire ..lien](url.. et non ..lien] (url.. )

Images

Pour afficher une image, il faut utiliser la syntaxe ![Texte alternatif](url_de_l'image)

Exemple :

Est obtenu par la syntaxe :

![Logo Markdown](https://upload.wikimedia.org/wikipedia/commons/thumb/4/48/Markdown-mark.svg/208px-Markdown-mark.svg.png)

N.B : il n'y a pas d'espace entre le crochet fermant et la parenthèse ouvrante. Il faut écrire ..lien](url.. et non ..lien] (url.. )

In [5]:

ls

GUIDO.md        GUIDO.pdf       MARKDOWN.ipynb  README.md

In [6]:

pwd

Out [6]:

'/Users/florian/Sites/Eleves/NSI/Première/markdown'

In [7]:

mkdir toto

In [8]:

ls

GUIDO.md        GUIDO.pdf       MARKDOWN.ipynb  README.md       toto/

In [9]:

rmdir toto

In [10]:

ls

GUIDO.md        GUIDO.pdf       MARKDOWN.ipynb  README.md

In [ ]: