Files
1ereNSI/markdown/MARKDOWN.ipynb

1 line
14 KiB
Plaintext
Raw Normal View History

2023-09-18 13:44:09 +02:00
{"cells":[{"metadata":{},"cell_type":"markdown","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![Logo Markdown](https://upload.wikimedia.org/wikipedia/commons/thumb/4/48/Markdown-mark.svg/208px-Markdown-mark.svg.png)\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 limpression 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 mardown, 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 [Basthon](https://notebook.basthon.fr/)\n\n\n## Formatage\n\nL'emphase est l'exagération dun mot ou d'une phrase en utilisant un style ou une fonte différente de celle du reste du texte — pour mettre laccent 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 javais un tel nez, il faudrait sur le champ que je lamputasse !, Edmond Rostand / Cyrano de Bergerac\n\nEst obtenu par la syntaxe suivantes :\n