# Autour du *Markdown*
### Découvrir
Le *Markdown* est une syntaxe qui permet d’écrire du [[texte structuré]] ^[c’est-à-dire non seulement du texte, mais, en plus, de marquer sa structure : titres, sous-titres, intertitres, liste numérotées, gras, italique, etc.] dans la simplicité et l’élégance, de plus en «[[plain text|texte pur]] » (“plain text”).
Voici
* la [[présentation du Markdown]] que j’ai écrite sur le présent site ;
* un [[document de démonstration pour le Markdown]] du *Markdown* que j’ai préparé ;
* en anglais, il y a une page intéressante sur la *Mac App Store* : [What is *Markdown* anyway?](https://apps.apple.com/ch/story/id1498656237?l=en)
⭢ [[à propos de la syntaxe Markdown]]
### Pour apprendre
On trouve beaucoup de choses sur internet. Je me suis cependant tout de même permis d’écrire un petit tutoriel qui devrait vous éviter de vous perdre dans de longs manuels. Je me suis concentré sur ce qui est utile au quotidien. Vous l’apprendrez en moins d’un quart d’heure, je vous le garantis. C’est cette page ⭢ [[apprendre le Markdown]].
Pour écrire en *Markdown*, on a le choix parmi toute une panoplie d’[[éditeurs de Markdown|éditeurs]], sur toutes les plateformes, tous très agréables, rapides et élégants. Vous en trouverez forcément un, voire plusieurs, à votre goût.
Au fil des ans, le *Markdown* est devenu un standard et l’on trouve sur le web plein, plein de ressources à son sujet. Surtout en anglais, certes, mais aussi en français. Il en sort pratiquement toutes les semaines, des ressources sur le *Markdown*. Je ne vais donc pas tenir à jour une index de ces ressources ; je préfère laisser faire les automates de *Google*. Le plus simple est de vous fournir quelques chaînes de recherches pertinentes — vous pouvez cliquer sans crainte sur les liens, c’est le moteur *DuckDuckGo* qui sera lancé ; c’est un moteur qui **ne conserve pas** l’historique de vos recherches.
#### Recherches utiles
En anglais :
| | |
| ------------------------------------------------------------ | ------------------------------------------------ |
| [what is Markdown](https://duckduckgo.com/?q=what+is+markdown&t=brave&ia=about) | pour en savoir plus |
| [markdown tutorial](https://duckduckgo.com/?q=markdown+tutorial&t=osx&ia=web) | pour apprendre |
| [writing in markdown](https://duckduckgo.com/?q=writing+in+markdown&t=osx&ia=web) | pour trouver des pages plus axées sur l’écriture |
En français :
| | |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| [qu’est-ce que le markdown](https://duckduckgo.com/?q=qu%E2%80%99est-ce+que+le+Markdown&t=brave&ia=about) | pour en savoir plus |
| [tuto markdown en français](https://duckduckgo.com/?q=tuto+markdown+en+fran%C3%A7ais&t=osx&ia=web) | pour apprendre |
| [écrire en Markdown](https://duckduckgo.com/?q=%C3%A9crire+en+Markdown&t=osx&ia=web) | pour trouver des pages plus axées sur l’écriture |
| [markdown tutorial français](https://www.youtube.com/results?search_query=markdown+tutorial+français) | directement dans *YouTube*, la recherche de tutos en français |
 
### Une mini sélection, quand même
En français :
* une [description en français](https://www.arthurperret.fr/tutomd/) de la syntaxe et un tuto recommandable.
* [un guide pour bien commencer avec Markdown](https://blog.wax-o.com/2014/04/tutoriel-un-guide-pour-bien-commencer-avec-markdown/) — il donne aussi quelques explications et un peu d’histoire.
* sur [Ionos, Digital Guide](https://www.ionos.fr/digitalguide/sites-internet/developpement-web/markdown/#c186777)
* [une vidéo](https://www.youtube.com/watch?v=6hikjzymd0c) sur *YouTube*
En anglais :
* [Getting started — Kicking the Tires](https://www.markdownguide.org/getting-started/#kicking-the-tires) sur le site *MarkdownGuide*.
* [MarkdownTutorial.com](https://www.markdowntutorial.com) — eh oui, il existe carrément un site spécifique dédié à l’apprentissage du *Markdown* ! Je ne vous recommande pas la traduction française, visiblement faite par *Google* : il traduit *Markdown* par « La démarque ». No comment.
* [Markdown basics](https://www.youtube.com/watch?v=bBk2kg8Gm_U&list=PL3NaIVgSlAVLHty1-NuvPa9V0b0UwbzBd&index=2&t=206s) — c’est un tuto de Nick Milo qui fait partie de sa série [Obsidian for Beginners](https://www.youtube.com/playlist?list=PL3NaIVgSlAVLHty1-NuvPa9V0b0UwbzBd), laquelle se trouve sur [Linking Your Thinking](https://www.youtube.com/channel/UC85D7ERwhke7wVqskV_DZUA), sa chaîne *YouTube*.
#### Autour d’*Obsidian*
⭢ [Comment utiliser *Obsidian* ?](https://www.youtube.com/watch?v=vXR5l2uHLpE) — un tuto complet d’un étonnant jeune gars de 16 ans, Elliott Meunier. Dans ce tuto, il y a quelques minutes sur le *Markdown*, à 18:30.
⭢ [Linking Your Thinking](https://www.youtube.com/channel/UC85D7ERwhke7wVqskV_DZUA) — la chaîne *YouTube* de Nick Milo. C’est un condensé remarquable de très bonnes ressources.
### Et dans *Wordpress* ?
Il fut un temps où il était très simple d’écrire dans *Wordpress* des pages entières en *Markdown*, sans devoir les convertir au préalable. Malheureusement avec la version **5** et l’éditeur “Guthenberg”, *Wordpress* a fait le choix d’imposer que toutes les pages soient faites de blocs, même les textes longs. Pour le moment (21.06.2021), ils ont maintenu une « rétro-compatibilité », mais en avertissant que ça ne va pas forcément durer. Affaire à suivre, car un très grand nombre d’utilisateurs se sont plaints. Heureusement, il existe au moins la possibilité d’utiliser un block de type “Markdown” dont le manuel est ici : [Markdown Block](https://wordpress.com/support/wordpress-editor/blocks/markdown-block/).
### Et les images ?
Incorporer des images dans du texte pur, ce n’est pas un problème trivial. J’ai écrit une page spéciale sur le sujet ⭢ [[Markdown et images]]
 
<p style="text-align: center;"><a href="https://dr-spinnler.ch"><img src="https://dr-spinnler.ch/myfiles/logos/Olivier-Spinnler.png" class= "signature"/></a></p>
<p style="text-align: center; font-style: italic;">le 28 septembre 2023
</p>
 
----------------------------------------------
[[environnement de travail de l’intellectuel non-geek]]
#informatique #écriture #markdown