"source": "# Guide d'utilisation Markdown\n\n## Introduction\n\nMarkdown est un _langage de balisage_ simple créé en 2004 par John Gruber avec l'aide d'Aaron Swartz. \n\nEn 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...).\n\nLe HTML est un autre langage de balisage. Le Markdown est un langage plus simple à appréhender; son apprentissage facilitera celui de l'HTML.\n\n\n\nIl a été créé dans le but d'offrir une syntaxe facile à lire et à écrire. \n\nUn 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.\n\n## Usages\n\nLe 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.\n\nCertains sites comme __discord__ permettent la gestion et l'affichage de texte au format Markdown.\n\nLa plupart des cours de NSI sont au format markdown, stocké sous la forme de fichier portant l'extension .md ou .ipynb.\n\nPour ouvrir, modifier ou visualiser les fichiers, il faut utiliser :\n\n- markdown (`.md`), il faut utiliser le logiciel [Typora](https://typora.io/) ou le logiciel en ligne [stackedit](https://stackedit.io/app#),\n- notebook (`.ipynb`), il faut utiliser le logiciel en ligne [Notebook](https://notebook.florianmathieu.prof)\n\n\n## Formatage\n\nL'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.\n\nEn markdown, l'emphase se manifeste par les caractères _ utilisés en paire.\n\n### Italique\n\nPour mettre une partie de texte en italique, il faut l'encadrer par un _.\n\n<u>Exemple</u> : Cette _partie du texte_ est en italique.\n\nEst obtenu par la syntaxe :\n```markdown\nCette _partie du texte_ est en italique\n```\n\n### Gras\n\nPour mettre une partie de texte en gras, il faut l'encadrer par un double __.\n\n<u>Exemple</u> : Cette __partie du texte__ est en gras.\n\nEst obtenu par la syntaxe :\n```markdown\nCette __partie du texte__ est en gras`\n```\n\n#### Remarque\n\nIl est possible de cumuler le formatage de texte.\n\n<u>Exemple</u> : Cette ___partie du texte___ est en italique et en gras.\n\nEst obtenu par la syntaxe constituée d'une paire de triples _\n```markdown\nCette ___partie du texte___ est en italique et en gras\n```\n\n\n### Paragraphe et saut de ligne\n\n\nPour 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).\n\n<u>Exemple</u> :\n\nPremier Paragraphe\nDeuxième Paragraphe\n\nEst obtenu par la syntaxe suivante :\n```markdown\nPremier Pragraphe\nDeuxième Paragraphe\n```\n\n<u>Exemple</u> :\n\nPremier Paragraphe\n\nDeuxième Paragraphe\n\nEst obtenu par la syntaxe suivante :\n```markdown\nPremier Pragraphe\n\nDeuxième Paragraphe\n```\n\n### Citation\n\nIl 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. \nLe texte est mis avec espace et une barre verticale afin de symboliser la citation.\n\n<u>Exemple</u> :\n\n> Moi, Monsieur, si j'avais un tel nez, il faudrait sur le champ que je l'amputasse !, Edmond Rostand / Cyrano de Bergerac\n\nEst obtenu par la syntaxe suivante :\n```markdown\n> Moi, Monsieur, si j'avais un t
"Les titres sont créés avec un certain nombre de #(croisillons) avant le titre, qui correspondent au niveau de titre souhaité (de 1 à 6).\n",
"\n",
"<u>Exemple :</u>\n",
"\n",
"# un titre de premier niveau\n",
"#### un titre de quatrième niveau\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```\n",
"# un titre de premier niveau\n",
"#### un titre de quatrième niveau\n",
"```"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Tableaux\n",
"\n",
"Un tableau en Markdown est constitué de 3 éléments :\n",
"\n",
"1. une ligne d'en-tête\n",
"1. une ligne de séparation\n",
"1. un ensemble de lignes de corps du tableau\n",
"\n",
"<u>Exemple</u> :\n",
"\n",
"| Titre 1 | Titre 2 | Titre 3 |\n",
"| :-- | :--: | --: |\n",
"| Colonne | Colonne | Colonne |\n",
"| Alignée à | Alignée au | Alignée à |\n",
"| Gauche | Centre | Droite |\n",
"\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```\n",
"| Titre 1 | Titre 2 | Titre 3 |\n",
"| :-- | :--: | --: |\n",
"| Colonne | Colonne | Colonne |\n",
"| Alignée à | Alignée au | Alignée à |\n",
"| Gauche | Centre | Droite |\n",
"```\n",
"\n",
"### En-tête\n",
"\n",
"L'en-tête contient chaque titre de colonnes, séparés par un symbole |. Le titre sera automatiquement mis en gras.\n",
"\n",
"### Séparation\n",
"\n",
"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.\n",
"\n",
"- `:--`: indique que le contenu est aligné à gauche de la colonne,\n",
"- `:--:`: indique que le contenu est centré,\n",
"- `--:`: indique que le contenu est aligné à droite de la colonne.\n",
"\n",
"### Corps\n",
"\n",
"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."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Liens\n",
"\n",
"Pour créer des liens de type url cliquable, il faut utiliser la syntaxe `[texte du lien](url_du_lien)`.\n",
"\n",
"<u>Exemple</u> : [Site du lycée Masséna](http://www.lycee-massena.fr/)\n",
"\n",
"Est obtenu par la syntaxe :\n",
"```\n",
"[Site du lycée Masséna](http://www.lycee-massena.fr/)\n",
"```\n",
"__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.. )__"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Images\n",
"\n",
"Pour afficher une image, il faut utiliser la syntaxe ``\n",
