# Noter le sens : la sémantique
Un texte véhicule du sens et est, en principe, structuré. La combinaison de ces deux éléments — le sens et la structure — relève de la *sémantique* et c’est bien celui qui écrit le texte qui doit s’en occupe ;, cela fait partie intégrante du processus d’écriture. Vous remarquez que, dans ce texte même, certains mots sont *mis en évidence*. Cela aussi, c’est de la sémantique.
Ainsi, nous avons besoin d’un moyen d’inclure dans le flux du texte des indications sur le sens et la fonction de certains éléments : telle séquence de mot est un titre principal, telle autre est un sous-titre ; tel mot doit être mis en évidence et ainsi de suite. On fait cela à l’aide de *balises* que l’on met dans le texte.
Si vous avez déjà vu du code HTML, vous craignez peut-être que ces balises n’alourdissent le texte et ne le rendent difficile à lire. ^[Voici un exemple de code HTML : [[HTML sample.webp|image de code HTML]]]. Heureusement, une solution particulièrement élégante a été trouvée : il s’agit de la syntaxe [*Markdown*](https://fr.wikipedia.org/wiki/Markdown), créée en 2004 par John Gruber. Même si elle n’est pas complètement standardisée — il y a de menues variations entre différentes implémentations —, on peut tout de même affirmer qu’elle est un standard *de facto* que tous les intellectuel·le·s, toutes les personnes qui composent du texte, devraient connaître. ^[Le *Markdown* couvre complètement les besoins de 99.99 % des gens. Si vous êtes ce 1 sur 10'000 à qui il manque quelque chose, je peux vous promettre que *Markdown* vous sera utile quand même ; vous aurez juste besoin de quelques astuces et outils supplémentaires pour aller plus loin que le système « de base ».]
### Les éléments sémantiques
Voici les éléments de base dont nous avons absolument besoin. Ils sont tous disponibles en *Markdown*.
* Des **titres** (“headings”) pour marquer différents niveaux hiérarchiques dans le texte. *Markdown* en prévoit 6. C’est plus qu’assez pour avoir
* un grand titre (niveau 1)
* des titres de sections (niveau 2)
* des intertitres (niveau 3)
* trois niveaux supplémentaires pour subdiviser encore le texte ou pour marquer de petites séquences telles que “Attention”, “À voir”, “Point de langue”, “À noter”, etc.
* La **mise en évidence** de mots ou séquences de mots : le **gras** et l’*italique* sont au rendez-vous. Notez bien que ce ne sont pas des « enjolivures » du texte comme au temps de la machine à écrire quand, à défaut de mieux, on en était réduit à les utiliser pour marquer des titres ou des sous-titres. Le *gras* et l’*italique* ne doivent être utilisés **que** pour la mise en évidence, *jamais* pour marquer un titre ou un sous-titre. C’est pourquoi il font partie de la sémantique. Il existe même une troisième sorte de mise en évidence : le ==surlignage== (“highlight”).
* Des **listes** pour des énumérations, des étapes, des séquences de pensées, etc. Il en existe deux sortes:
* la liste *non numérotée*, dite « liste à puces » — “bullet list” en anglais ;
* la liste *numérotée* ;
*Markdown* permet d’imbriquer et de mélanger les listes sur plusieurs niveaux, comme vous le constatez dans le présent document.
* Une manière d’écrire des **citations**, que celles-ci soient brèves ou longues.
* Une manière d’écrire des *liens*, c’est-à-dire des renvois vers une autre fiche de notre *corpus de connaissance* ou vers des pages *Internet*.
* Des **notes de bas de page** (“footnotes”).
Et c’est tout ! Avec ces quelques éléments sémantiques, nous couvrons 99 % des besoins de 99 % des utilisateurs. Comme la syntaxe est très simple, vous verrez que c’est vite appris. Je suis absolument certain que vous avez déjà appris des choses bien plus difficiles et bien plus compliquées. Alors, je vous en prie : mettez-vous-y !
⭢ prochaine étape : [[présentation du Markdown]]
 
<p style="text-align: center; font-style: italic;">~~ Olivier Spinnler, le 23.10.2021
 ~~</p>
----------------------------------------------------------------------
[[environnement de travail de l’intellectuel non-geek]] ✦ [[le texte, au centre de tout]]