~/tilder/, fr/, Documentation/, Référence/, La référence Markdown/, Balisage en ligne

inline - gras, italique, barré, souligné, code et liens

Dans un paragraphe, un élément de liste, une cellule de tableau, une légende ou le titre ### d'une entrée, tilder lit six constructions et rien d'autre. Chacune est montrée ci-dessous en source, puis rendue dans un cadre, comme elle s'affiche dans n'importe quelle phrase du site.

Deux astérisques de chaque côté mettent le texte en gras. Un astérisque ou un tiret bas de chaque côté le mettent en italique.

Un mot en **gras**, un en *italique*, et _un autre_ encore.

Les deux s'écrivent de façon à laisser le texte ordinaire tranquille :

• *italique* ne doit pas toucher d'espace à l'intérieur, si bien que 2 * 3 * 4 reste tel quel ;
• _italique_ ne fonctionne qu'autour de mots entiers, si bien que snake_case reste tel quel.

2 * 3 * 4 font 24, et snake_case n'est pas en italique.

Sur la page web, le gras est <b> et l'italique <em>. Le miroir en texte imprime les mots seuls, sans les marques.

Un paragraphe entièrement entouré d'astérisques simples n'est pas en italique : c'est un état vide.

Deux tildes de chaque côté barrent le texte ; deux signes plus de chaque côté le soulignent, d'un trait pointillé, car un soulignement plein se lit comme un lien sur le web.

La rencontre a lieu ~~vendredi~~ samedi, ++à midi++.

++souligné++ suit la même règle que l'italique : pas juste après une lettre, et sans toucher d'espace à l'intérieur, si bien que C++ et 1 ++ 2 restent tels quels. Sur la page web, ce sont <del> et <u class="u">. Le miroir en texte imprime le texte barré avec ses tildes, ~~vendredi~~ : les ôter changerait le sens. Le texte souligné est imprimé tel quel.

Un mot ou une expression entre accents graves est du code : en police à chasse fixe, et jamais lu pour un autre balisage.

Lancez `python3 builder/build.py`, et gardez **`--watch` actif** pendant que vous écrivez.

La fin de cet exemple montre aussi la règle suivante : pas d'imbrication. Le gras garde les accents graves tels quels, pas du code. Le code ne peut pas non plus contenir d'accent grave. Dans le miroir en texte, le code est imprimé tel quel, et coloré dans le miroir ANSI.

[libellé](cible) est un lien. La cible s'écrit depuis la racine du site, sans barre oblique au début et sans .html ; la construction la rend relative à la page.

Lisez [le guide](docs/guide), ou l'[exemple ↗](https://example.org/).

La page liens et images donne chaque genre de cible : les ancres, les liens d'une langue à l'autre, les fichiers et les autres sites.

Les six constructions ne s'imbriquent pas : la première trouvée l'emporte, et garde son contenu en texte brut. Il n'y a pas de caractère d'échappement : une barre oblique inverse est un caractère ordinaire, elle s'imprime, et n'arrête pas le balisage qui la suit. Tout le reste, HTML compris, est imprimé tel qu'il est écrit.

**[un lien](docs/)** est en gras, et <b>ceci</b> ne l'est pas.
a \*b* c

La première ligne fait un paragraphe : du gras qui contient la source d'un lien, du HTML affiché en texte. La seconde montre la barre oblique inverse : a \*b* c imprime a \, puis un b en italique, puis c - la barre oblique n'a pas empêché l'astérisque qui la suit d'ouvrir l'italique. Reformulez plutôt que d'échapper. La seule exception : dans une cellule de tableau, \| est une barre verticale (tableaux).

Le miroir en texte imprime les mots de chaque construction et ôte leurs marques, sauf les tildes du texte barré. Un lien interne ne garde que son libellé, puisqu'un lecteur dans un terminal le suit avec curl et non en le recopiant ; un lien vers un autre site imprime son adresse entre parenthèses après le libellé. Les accents et les caractères typographiques sont ramenés à l'ASCII : les lettres accentuées perdent leur accent, les guillemets et les tirets typographiques deviennent simples, et la flèche nord-est des liens externes disparaît. Les lignes sont coupées à 75 colonnes (le miroir en texte).

• liens et images
• les blocs
• le miroir en texte