Markdown

Google Docs intègre nativement markdown. Ceci est une révolution...

Soumis par francoistonic le
Image
markdown

Hourra, Google annonce l'intégration native de Markdown dans Google Docs et Google Drive. On aurait pu penser que c'était déjà le cas... mais non.

Markdown (.md) est un format de texte standard pour préserver le contenu structuré (tableaux, titres, listes à puces, etc.) sans les contraintes des formats de fichiers volumineux. 

Fièrement, Google annonce que nous pouvons maintenant avec un fichier .md :

- Fidélité au format natif : Gérez et modifiez vos fichiers .md directement dans Google Docs, sans conversion. Un badge .md visible dans l’en-tête du document indique clairement que vous travaillez sur un fichier Markdown natif.

- Collaboration en temps réel : Vos collègues et les agents IA peuvent coéditer le même fichier afin de garantir une source unique de vérité pour les outils d’ingénierie, de produit et d’IA. Vous pouvez également utiliser les commentaires Google Docs pour laisser des retours en temps réel, ligne par ligne, et suivre les suggestions.

- Historique des versions : Conservez un historique complet et transparent de toutes les modifications apportées par les contributeurs humains et les agents IA.

- Stockage dans Drive : Prévisualisez vos fichiers Markdown enrichis et formatés directement dans Drive (avec prise en charge complète des tableaux et des liens hypertextes) ou basculez facilement vers le texte brut sans avoir besoin d’une visionneuse externe.

Les diagrammes Mermaid sur Visual Studio Code : natif et facile à visualiser

Soumis par francoistonic le
Image
Image

Visual Studio Code a beaucoup amélioré le support Markdown. Dans les dernières versions, deux fonctions importantes sont arrivées : les diagrammes Mermaid et le module previewer. Mermaid permet de créer une grande variété de diagrammes directement en Markdown. A l'origine, il ciblait JavaScript avec une description proche du markdown.

Plus de 30 types sont possibles :

  • Flowchart
  • Sequence
  • Block
  • Class
  • Entity Relationship
  • Gantt
  • Mindmap
  • State
  • Timeline
  • Gitgraph
  • C4
  • Sankey
  • Pie chart
  • Quadrant
  • Requirement
  • User Journey
  • Sankey
  • XY chart
  • Kanban
  • Architecture
  • Packet
  • Radar

C'est la liste des diagrammes supportés par l'extension officielle Mermaid. Désormais, inutile d'utiliser une extension sur VS Code car le support est natif. Depuis la version 1.121, on dispose aussi d'une prévisualisation directement sur l'éditeur. Ce qui est particulièrement pratique pour tester et corriger immédiatement le markdown. Cette fonction supporte les zoom + et -. Sur Mac, sur un fichier .md, il suffit de faire : Maj+Command+V pour afficher le markdown et revenir au code. 

Tous les détails sur le support Markdown sur VS Code : https://code.visualstudio.com/docs/languages/markdown

mdpdf : convertir vos fichiers markdown en PDF

Soumis par francoistonic le

Vous êtes fidèle aux documents markdown mais vous avez besoin de générer des fichiers PDF à partir des fichiers .md ? L'outil mdpdf est fait pour vous ! Il permet très simplement de convertir un fichier .md avec les en-têtes, les styles, etc. L'outil est personnalisable à vos besoins. 

Installation : npm install mdpdf -g ou via pip pour Python

Son usage est très simple : mdpdf [fichier.md]. Il est possible de pousser plus loin avec des paramètres optionnels : style, header, footer, border, etc. 

GitHub : https://github.com/elliotblackburn/mdpdf/tree/master

Sphinx + Markdown : créer un site web

Soumis par francoistonic le

Créer un site web avec Sphinx et Markdown ? Mike Driscoll relève le défi ! Sphinx est un puissant outil pour créer les documents techniques sur nos projets Python. ReStructuredText et Markdown. Il est possible de mixer les deux "univers".

Chaque page de la documentation ou d'un site web peut être écrit avec l'un ou l'autre ou les deux. 

1 / les dépendances

Il faut installer sphinx et myst-parser en utlisant venv pour disposer d'un environnement de développement virtuel. 

python -m venv NAME_OF_VENV_FOLDER

python -m pip install myst-parser sphinx

Puis, il faut installer sphinx via pip (pip3 si vous êtes sur Python 3). 

2 / création du site

Ensuite, nous créons un projet Sphinx qui fournira la structure du projet. On utilise sphinx-quickstart [nom du site]

Puis nous indiquons à notre projet Sphinx que nous allons utiliser markdown. C'est là que myst_parser joue son rôle. 

3 / Buildons !

Voilà notre projet, très simple, peut être buildé : sphinx-build -M html .\source\ .\build\

Les fichiers HTML sont créés automatiquement dans le dossier build/html. Bien entendu, vous pouvez étendre le contenu et les pages. 

Post source : https://www.blog.pythonlibrary.org/2025/07/01/creating-a-website-with-sphinx-and-markdown/

Meetup #43 : nouvelle date !

Soumis par fredericmazue le

Nous avons du déplacer la date de notre meetup #43 qui se tiendra donc le 2 juillet 2024. Au programme de cette session :

Accueil à partir de 18h15
Début de la session vers 18h4518h30 - 18h55 : bilan de la saison 2023-2024, les annonces techs à retenir
A partir de de 18h55 : Christophe Villeneuve poursuit la découverte de l'étonnant Markdown !

Pizza party pour terminer la soirée !

Meritis
36 Av. Pierre 1er de Serbie · Paris

Inscriptions

Notre meetup #39 sera consacré à Markdown

Soumis par fredericmazue le

Notre meetup #39, qui se déroulera le 6 février 2024, sera consacré à Markdown.  Markdown est un langage de balisage léger, très répandu dans les documentations et manuels en ligne avec les avantages des langages de programmation ou interprétés.

Cependant, il est possible d'aller plus loin avec Markdown. C'est ce que Christophe montrera dans sa session. Voici une occasion de voir la transformation des données en une transformation dynamique, voire beaucoup plus...

Intervenant : Christophe Villeneuve est Consultant Open Source à Atos/Eviden. Il est impliqué dans de nombreuses technologies tels que PHP, Drupal, MariaDB, Mozilla Firefox, Lizard secu... Il est aussi chroniqueur radio, auteur de Livres d'articles dans différents magazines et le PHPère des elePHPants.

Inscriptions

readme-md-generator : Un générateur de fichiers README.md

Soumis par fredericmazue le
Image

Un fichier README est un fichier texte qui introduit et explique un projet. Il contient des informations communément requises pour comprendre le sujet du projet. Les services d'hébergement de code tels que GitHub , Bitbucket et GitLab demandent que votre projet comporte un fichier README.

Théoriquement les fichiers README peuvent être écrits dans n'importe quel format de fichier texte. Mais dans la pratique Markdown, qui est un langage de balisage léger, est utilisé pour la mise en forme de texte brut. Le fichier README devient alors README.md ainsi qu'on peut le voir dans les projets hébergés par GitHub.

L'outil readme-md-generator est capable de lire votre environnement (packqhe JSON, git config, etc.) pour vous suggérer les réponses par défaut durant le processus de création du fichier README.md. Ainsi que le montre l'animation ci-dessous, et le résultat produit par readme-md-generator pour le projet readme-md-generator :-)

readme-md-generator est un logiciel libre sous licence MIT disponible sur GitHub.