Markdown dans la programmation Christophe Villeneuve @hellosct1 @[email protected] Meetup #39 

Atos open source - afup – lemug.fr – mariadb – drupal – mozilla - firefox – lemugfr - sumo – webextensions – VR – AR – XR - Cause commune 93.1 FM - TechSpeaker - Lizard - eyrolles – editions eni – programmez – linux pratique – webriver – elephpant - CommonVoice – Sécurité - Cybersécurité Christophe Villeneuve ● Consultant Open Source ● Dresseur animaux 

@hellosct1 – Meetup #39 - 2024 Aujourd’hui ● Le markdown ● Première page ● Version Dynamique 

@hellosct1 – Meetup #39 - 2024 ● Le markdown ● Première page ● Version Dynamique 

@hellosct1 – Meetup #39 - 2024 Qu’est ce que le Markdown ● Créé par John Gruber en 2004 ● Langage de balisage léger – Possibilité d’ajouter des éléments de formatage aux documents ● L'utilisation de Markdown – n’est pas la même que ● l'utilisation d'un éditeur WYSIWYG ● Appeler « texte en clair » ● Exemple de sites webs : Github, Reddit 

@hellosct1 – Meetup #39 - 2024 Formatage Markdown ● Formatage/syntaxe du Markdown – Ajout au texte quels mots et phrases devraient être différents. ● Exemple 

@hellosct1 – Meetup #39 - 2024 Utiliser Markdown ? ● Markdown peut être utilisé pour tout. ● Création des sites web ● des documents ● des notes ● des livres ● des présentations ● des messages électroniques ● documentation technique ● Markdown est portable ● Compatible – toutes plateformes / OS ● ● Exemples – Fichiers à Plat – Des livres – Thèses universitaires – Documents... 

@hellosct1 – Meetup #39 - 2024 Fonctionnement du Markdown ● Processus en quatre parties – Créer un fichier Markdown ● Avec un éditeur de texte ou d'une application dédiée – Ouvrez le fichier Markdown dans une application Markdown. – Utilisez un IDE Markdown ● Option possible de conversion Markdown en un document HTML. – Visualisez le fichier HTML dans un navigateur web ● Possible d’avoir d’autres formats 

@hellosct1 – Meetup #39 - 2024 ● Le markdown ● Première page ● Version Dynamique 

@hellosct1 – Meetup #39 - 2024 Documentation # Meetup 39 ## Exemple 1. Exemple d'implémentation 1. Afficher un logo  1. Construction d'un tableau : | Titre | Description | | --- | :--- | | *Programmez !* | Le magazine des **dév**eloppeurs | | Lieu du meetup | The Coding Machaine | | Date | 06 février 2024 | 1. Un message dans une note >[!NOTE] > > A découvrir 

@hellosct1 – Meetup #39 - 2024 Custom Markdown ● Gras ● Italique ● Listes à puces ● Listes numérotées ● Listes imbriquées ● Titres ● Blocs de citation ● Code incorporé ● Blocs de code ● Images ● Liens ● Images servant de liens ● Liens vers les tickets ● Ligne de séparation horizontale ● Saut de ligne ● Trait de soulignement 

@hellosct1 – Meetup #39 - 2024 Compilation pour MD → PDF ● sudo apt install pandoc ● Ajout les langues du monde – sudo apt install texlive-lang-all ● ​ Ajout les langues européennes – sudo apt install texlive-lang-european ● Ajout la langue Française – sudo apt install texlive-lang-french 

@hellosct1 – Meetup #39 - 2024 Ligne de commandes ● Extension Beamer – Exemple pour convertir MD vers PDF $ pandoc -st beamer \ -V theme:Custom \ -V lang:fr-FR \ "main.md" \ -o "main.pdf" \ --slide-level=2 \ --dpi=300 

@hellosct1 – Meetup #39 - 2024 ● Le markdown ● Première page ● Version Dynamique 

@hellosct1 – Meetup #39 - 2024 WebSite ● Ajout de LaTeX ● 

@hellosct1 – Meetup #39 - 2024 Et la suite... PROCHAINEMENT 

@hellosct1 – Meetup #39 - 2024 Plus loin ● Bien démarrer : – Dillinger https://dillinger.io/ ● Apprendre Markdown : https://www.markdowntutorial.com ● Générer de la documentation – Read The Docs https://readthedocs.org/ ● Générer des sites statique : – Mkdocs https://www.markdownguide.org/tools/mkdocs/ – Docusaurus https://www.markdownguide.org/tools/docusaurus/ ● Site statique pour Docs techniques : – VuePress https://vuepress.vuejs.org/ ● Générer documentations techniques – Jekyll : https://www.markdownguide.org/tools/jekyll/ ● 

@hellosct1 – Meetup #39 - 2024 Ressources supplémentaires ● Fichiers sources des démos – https://github.com/hellosct1/markdown-in-programmation ● Podcast de la présentation – https://www.youtube.com/watch?v=kL7oLOc-4bE 

Christophe Villeneuve @hellosct1 @[email protected] Merci