Le Markdown en un coup d’œil

Chaque note Varlig est un document Markdown : quelques symboles simples suffisent pour les titres, les listes et la mise en valeur du texte. Saisissez-les ou utilisez le menu Format et ses raccourcis : Varlig met la note en forme au fil de la saisie. Cette page présente les possibilités d’un seul coup d’œil, avec des liens vers les explications détaillées.

Vous découvrez Markdown ? Votre première note vous accompagne pas à pas dans l’apprentissage des bases.

Toutes les possibilités du Markdown dans une note

Voici une note qui utilise un peu de tout. À gauche figure le texte exactement tel qu’il est enregistré ; à droite, le résultat affiché dans Varlig.

# Lisbon weekend
Flights are **booked** and the hotel is ==paid==. #travel/portugal

## Before we go
- [x] Book the hotel
- [ ] Download the offline map
- [ ] Read [[Lisbon bookings]]

> [!TIP] Tram 28
> Board at the first stop to get a seat.

| Day      | Plan              |
| -------- | ----------------- |
| Saturday | Castle and Alfama |
| Sunday   | Belém             |

```calc
hotel = €145 * 2
hotel / 2
```

Comment Varlig affiche le Markdown

Varlig masque les symboles pour faciliter la lecture et les affiche de nouveau lorsque vous en avez besoin :

• Styles et liens : les symboles **, _, ~, == et les crochets restent masqués tant que le curseur ou la sélection ne se trouve pas dans le texte mis en forme.
• Titres : les signes # restent toujours masqués. Lorsque le curseur se trouve dans un titre, une icône dans la marge indique son niveau.
• Listes : les puces s’affichent sous forme de points et les tâches sous forme de cases à cocher. Les numéros conservent leur forme d’origine.
• Citations : le signe > reste discrètement visible. Les encadrés masquent leur marqueur [!TIP] tant que le curseur ne s’y trouve pas.
• Blocs de code et de calcul : les lignes d’accents graves qui les délimitent restent masquées tant que le curseur ne se trouve pas dans le bloc.
• Tableaux, images et séparateurs : ils s’affichent directement dans la note. Leur syntaxe Markdown devient visible lorsque la recherche Find (⌘F) est ouverte.
• Tags : ils s’affichent sous forme de petites pastilles.

Pour voir le Markdown complet d'une note, ouvrez le menu … de la note et choisissez Copy As › Markdown, puis collez-le n'importe où.

Aide-mémoire

Texte

Structure

Listes

Liens et tags

Blocs

Images et fichiers

Nombre de mots et objectifs

View › Show Word Count affiche le nombre de mots en bas de l’éditeur. Si vous sélectionnez du texte, seul celui-ci est compté. La syntaxe Markdown est exclue du décompte.

Note › Set Writing Target… définit un objectif pour la note, en mots avec Words ou en caractères avec Characters. Une pastille indique votre progression, par exemple 312 of 500 words · 188 to go, puis Target reached. Définir un objectif affiche cette pastille pour la note, même si le compteur est désactivé. Remove Target la retire.

Les caractères sont comptés tels qu’ils sont lus : chaque lettre, chiffre, signe de ponctuation ou emoji compte pour un, ainsi qu’un espace entre les mots d’une même ligne. La syntaxe Markdown, les espaces supplémentaires et les sauts de ligne sont exclus. Modifier la mise en forme ne change donc pas le total. Si l’objectif est défini en caractères, le décompte d’une sélection utilise aussi les caractères.

View › Typewriter Scrolling maintient la ligne en cours de saisie au centre vertical de l’éditeur. Le recentrage ne se produit que lorsque vous saisissez ou supprimez du texte : la sélection et le défilement manuel conservent leur fonctionnement habituel.

Notes dans des onglets

Une note peut s’ouvrir dans une fenêtre distincte avec File › New Note in New Window (⌥⌘N), ou dans un onglet avec File › New Note in New Tab (⌃⌘N). Le bouton + de la barre d’onglets et la commande macOS New Tab créent également un onglet. Pour rassembler les notes sur lesquelles vous travaillez, faites glisser une fenêtre de note sur la barre d’onglets d’une autre, ou choisissez Window › Merge All Windows.

Chaque onglet conserve l’état complet de sa note : le curseur, la sélection et la position de défilement restent exactement à leur place lorsque vous passez d’un onglet à l’autre. Une note protégée affiche le titre Protected note dans la barre d’onglets lorsqu’elle est verrouillée. Le verrouillage ne ferme pas son onglet.

La fenêtre principale de la bibliothèque ne prend pas en charge les onglets. Elle contient la barre latérale et la liste des notes, et il n’en existe qu’une seule.

Touches utiles pendant la saisie

• Return poursuit une liste à puces, une liste numérotée ou une citation. Appuyez sur cette touche dans un élément vide pour quitter la liste ou la citation.
• Tab augmente le retrait des éléments de liste et du code ; Shift-Tab le réduit.
• #, [[ et : proposent respectivement des tags, des titres de notes et des emoji. Parcourez les suggestions avec les touches fléchées, puis validez avec Retour ou Tab.
• Dans un bloc de calcul, Escape affiche des suggestions de noms de fonctions.

La page Raccourcis clavier réunit tous les raccourcis.