Titres et styles de texte

Structurez une note avec des titres et mettez en valeur les mots importants. Tout ce qui suit utilise du Markdown ordinaire : saisissez les marqueurs ou utilisez le menu Format et ses raccourcis. Varlig masque les marqueurs pendant la rédaction pour préserver la lisibilité.

Titres

Commencez une ligne par un à six signes # suivis d’un espace, ou placez-y le curseur et utilisez ⌘1 à ⌘6. Répétez le même raccourci pour reconvertir le titre en texte ordinaire.

# Holiday plans
## Things to pack
### Documents

Les signes # restent masqués, même pendant la modification de la ligne. Quand le curseur se trouve dans un titre, une icône dans la marge indique son niveau. Cliquez dessus pour changer ce niveau, replier la section, ou choisir Copy Link to here afin de créer un lien direct vers cette section depuis une autre note. Voir Tags, liens et liens entrants.

Vous pouvez aussi placer une ligne de marqueurs sous le texte pour en faire un titre : === crée un titre de niveau 1 et --- un titre de niveau 2.

Replier une section

Avec le curseur dans une section, utilisez ⌘' pour replier son contenu, puis répétez le raccourci pour le déplier. Format › Unfold All déplie toutes les sections. Un élément de liste contenant des éléments imbriqués se replie de la même façon.

Replier les sections permet de voir la structure d’une longue note. Dès que vous recommencez à saisir du texte, toutes les sections se déplient.

Pour naviguer rapidement dans une longue note, View › Toggle Table of Contents (⇧⌘A) affiche la liste de ses titres de section.

Une table des matières dans la note

Format › Insert Table of Contents insère sous la ligne du curseur une liste de liens vers les titres de section, imbriquée selon leurs niveaux et placée entre deux lignes de commentaire :

<!-- contents -->
- [Before you go](varlig://open-note?id=…&header=Before%20you%20go)
  - [Packing](varlig://open-note?id=…&header=Packing)
<!-- /contents -->

Chaque lien est identique à celui produit par Copy Link to here : un clic mène donc directement à la section. La ligne de titre de la note et les titres situés dans du code ne sont pas inclus.

La liste ne s’actualise pas automatiquement. Format › Update Table of Contents la réécrit à partir des titres actuels ; Insert Table of Contents actualise également une table des matières déjà présente. Chaque commande s’annule en une étape. Les autres apps Markdown masquent les lignes de commentaire et affichent la liste des titres, dont les liens ouvrent la note dans Varlig.

Les deux commandes fonctionnent dans les notes modifiables de votre bibliothèque. Une table des matières ne peut pas être insérée dans du code, des formules mathématiques, un tableau ou les métadonnées initiales (front matter).

Gras, italique et autres mises en forme

Sélectionnez quelques mots et appuyez sur un raccourci, ou tapez les symboles autour d'eux. Sans rien sélectionné, un raccourci active le style pour ce que vous tapez ensuite ; appuyez à nouveau dessus pour l'éteindre.

The ferry is **not** refundable, so _double-check_ the date.
Bring the ==blue folder== and ~sign~ the forms, but ~~print the maps~~.
Booking reference: `LX-4821`

*italic* et __bold__ fonctionnent aussi. Avec le curseur à l'intérieur d'un style, son raccourci le supprime.

Couleurs de surlignage

Choisissez Format › Highlight Color pour le vert, le rouge, le bleu, le jaune ou le violet, ou Default. Dans le Markdown, la couleur est un emoji juste après l'ouverture == :

L’emoji reste masqué tant que le curseur n’est pas dans le passage surligné. Il devient alors une commande permettant de choisir la couleur.

View › Toggle Highlights (⇧⌘H) répertorie les passages surlignés sous leurs titres de section, dans leurs couleurs. Copy Highlights les copie tous sous forme de liste Markdown. Voir Informations de la note.

Citations et encadrés

Commencez une ligne par > pour créer une citation (⇧⌘T). Retour poursuit la citation ; Retour sur une ligne vide la termine.

Un encadré attire l’attention sur un point. Choisissez Format › Callout et un type, ou saisissez > [!TIP], éventuellement suivi d’un titre :

> [!TIP] Before you leave
> Check the passports are in the front pocket.

> [!WARNING]
> The last ferry leaves at 18:30.

Les types disponibles sont NOTE, TIP, IMPORTANT, WARNING et CAUTION, en majuscules. Sans titre personnalisé, l’encadré affiche le nom du type. Avec le curseur dans un encadré, Format › Callout permet de changer son type.

Séparateurs

Format › Line Separator (⌥⌘S) trace une ligne entre les sujets. Pour en taper un, mettez --- sur sa propre ligne avec une ligne vide au-dessus. Sans la ligne vide, --- transforme la ligne ci-dessus en titre.

Notes de bas de page

Format › Footnotes › Footnote (⇧⌘E) insère un renvoi numéroté tel que [^1] au curseur et une ligne correspondante [^1]: footnote text à la fin de la note, prête à être complétée. Le renvoi apparaît en petit chiffre en exposant, sur lequel vous pouvez cliquer. Renumber Footnotes rétablit l’ordre des numéros après des déplacements de texte.

The castle opens at nine.[^1]

[^1]: Closed on Mondays in winter.

Indications de prononciation

Une annotation de lecture indique la prononciation au-dessus d’un mot : furigana au-dessus de kanji, ou translittération au-dessus d’un nom. Placez le texte de base entre crochets, puis la lecture entre accolades immédiatement après :

子どもの頃に[漢字]{かんじ}を覚えました。

Sélectionnez le texte et choisissez Format › Add Reading…. La fenêtre porte un titre comme Reading for "漢字" et contient un champ Reading. Add insère le balisage en une seule modification annulable.

Avec le curseur dans une annotation de lecture, le clic droit propose Edit Reading… et Remove Reading. La fenêtre affiche alors Save et Remove Reading ; supprimer l’annotation conserve le texte de base. Dans une note en lecture seule, la commande est Show Reading….

Dans l’éditeur, la lecture s’affiche en petits caractères au-dessus du texte de base. Comme pour les autres marqueurs Markdown, les délimiteurs restent masqués tant que le curseur ou la sélection n’entre pas dans l’annotation. Les titres de notes, extraits de listes, extraits de liens entrants et compteurs de mots utilisent uniquement le texte de base.

Les caractères ]{ doivent se toucher, sans espace entre le crochet et l’accolade : [漢字] {かんじ} reste donc du texte ordinaire. Le texte de base ne peut contenir ni [ ni ] ; la lecture, ni { ni }. Aucun des deux ne peut contenir de tabulation ou de saut de ligne, et chacun est limité à 120 caractères. Une seule lecture par texte de base, sans imbrication. On ne peut pas ajouter de lecture dans du code, des formules mathématiques, une lecture existante ou du texte commenté.

Chaque format d’export affiche les annotations de lecture selon ses possibilités :

Les parenthèses <rp> des exports HTML et EPUB permettent aux lecteurs qui ne prennent pas en charge les annotations ruby d’afficher tout de même la lecture entre parenthèses.

Dates, emoji et caractères spéciaux

• Date du jour : Format › Current Date insère la date et l’heure (⇧⌘7), la date (⇧⌘8), une date courte (⇧⌘9) ou l’heure (⇧⌘0), selon le format du Mac. Le même menu propose des variantes ISO 8601, comme 2026-09-16, pour les notes triées par date.
• Emoji : tapez un deux points et le début d'un mot, tel que :ten, et choisissez parmi les suggestions. Varlig insère l'emoji lui-même.
• Un symbole littéral : ajoutez une barre oblique inverse devant un caractère pour empêcher son interprétation comme mise en forme. Ainsi, \#1 reste du texte au lieu de devenir un tag.

Déplacer et indenter des lignes

Décaler une ligne ajoute ou retire deux espaces, ce qui permet d’imbriquer les listes. Voir Listes et tâches.

Utiliser les boutons

View › Toggle Style Bar (⇧⌘Y) affiche les boutons de formatage au-dessus de la note. Et lorsqu'une note est terminée, Note › Make Read-Only la protège contre les modifications accidentelles.