Aide-mémoire Markdown

Agenda n’est pas un éditeur markdown, mais l’app reconnaît malgré tout une partie de la syntaxe markdown pour appliquer des styles. Voici les raccourcis markdown que vous pouvez utiliser.

Styles de paragraphe

Les styles suivants modifient l’apparence du paragraphe entier.

Titre

Utilisez de 1 à 6 dièses en début de ligne, suivis d’une espace. Le niveau de titre est déterminé par le nombre de dièses. Ex. : ### Exemple produit un titre de troisième niveau.

Liste à tirets ou à puces

Commencez une ligne par une puce, un trait d’union, un astérisque ou un signe plus pour créer un élément de liste à tirets. Ex. : • Élément d’exemple 1 - Élément d’exemple 2 * Élément d’exemple 3 + Élément d’exemple 4 produit un élément de liste à tirets ou à puces.

Liste numérotée

Commencez une ligne par un chiffre suivi d’un point et d’une espace pour créer un élément de liste numérotée. Ex. : \1. Élément d’exemple 1 produit un élément de liste numérotée.

Pour démarrer une liste numérotée à un autre chiffre que 1, utilisez simplement ce chiffre. Ex. : \3. Élément d’exemple 3 produit un élément de liste numérotée commençant à 3.

Liste de tâches

Commencez une ligne par un trait d’union suivi d’un crochet ouvrant et d’un crochet fermant. En insérant un « x » entre les deux crochets, vous créez un élément coché. Ex. : - [ ] Exemple produit un élément de liste de tâches.

- [x] Exemple produit un élément coché.

Le trait d’union est facultatif : vous pouvez donc aussi créer une case à cocher en utilisant simplement deux crochets.

Préformaté

Pour du contenu qui se prête mieux à une police à chasse fixe, comme du code informatique, vous pouvez appliquer le style préformaté. Vous déclenchez ce style en commençant la ligne par trois accents graves. Ex. : ```exemple produit exemple

Code

Agenda prend en charge la coloration syntaxique du code informatique. En ajoutant le langage après les trois accents graves, vous pouvez indiquer dans quel langage l’extrait de code a été écrit. Ex. : ```swift int i = 0; produit int i = 0 coloré selon le langage Swift

La liste complète des paramètres de langage pris en charge est tenue à jour par le projet highlight.js à l’adresse https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md.

Citation

Utilisez un ou plusieurs symboles > en début de ligne, suivis d’une espace. Le nombre de caractères > détermine le niveau de citation, indiqué par les lignes verticales qui précèdent le texte. Ex. : > Exemple produit

Exemple

Styles en ligne

Ces styles s’utilisent à l’intérieur des paragraphes pour modifier l’apparence du texte.

Italique

Encadrer par des tirets bas ou des astérisques applique le style italique. Ex. : _exemple_ ou *exemple* produit exemple

Gras

Encadrer par des doubles tirets bas ou des doubles astérisques applique le style gras. Ex. : __exemple__ ou **exemple** produit exemple

Barré

Encadrer par des doubles tildes applique le style barré. Ex. : ~~exemple~~ produit exemple

Chasse fixe (monospace)

Pour certains contenus, comme du code source informatique, il est préférable d’avoir un texte à chasse fixe. Pour des blocs de texte, mieux vaut utiliser le style de paragraphe Préformaté. Pour du texte en ligne, vous pouvez l’encadrer par des accents graves. Ex. : `exemple` produit exemple

Surlignage

Encadrer par des doubles signes égal ou des doubles deux-points applique le style surligné. Ex. : ==exemple== ou ::exemple:: surligne le mot exemple

Insertion

Certains styles ne concernent pas le sens du texte, mais servent à délimiter des éléments d’information tels que les tags. Ils peuvent eux aussi être saisis avec une syntaxe proche du markdown.

Tags

Pour saisir un tag, utilisez simplement le symbole #, suivi du tag. Le tag ne peut pas contenir d’espaces. Ex. : Tapez #giraffes pour créer un tag nommé « giraffes ».

Taper un # déclenche l’affichage du menu d’auto-complétion qui vous aide à trouver le tag que vous cherchez.

Les tags peuvent également contenir un paramètre entre parenthèses. Par exemple, #due(12/12/2018). Pour en savoir plus sur la façon d’exploiter pleinement les paramètres dans les tags, consultez le chapitre Tags, personnes, actions de texte et liens.

Tags de personnes

Agenda reconnaît un second type de tag réservé aux individus (les personnes). Vous pouvez saisir un nom ou des initiales pour faire référence à un ami ou à un collègue. Il suffit de placer le symbole @ devant le texte. Ex. : Saisissez @Tom pour créer un tag de personne pour quelqu’un qui s’appelle « Tom ».

Taper un @ déclenche l’affichage du menu d’auto-complétion qui vous aide à trouver la personne que vous cherchez.

Emoji

Pour saisir un emoji, tapez simplement : (le caractère deux-points), suivi de l’abréviation de l’emoji, puis à nouveau : pour fermer. Ex. : Tapez :+1: pour insérer l’emoji 👍.

Taper un : déclenche l’affichage du menu d’auto-complétion qui vous aide à trouver l’emoji que vous cherchez.

Filet horizontal

Si vous souhaitez délimiter visuellement des sections dans vos notes à l’aide d’un filet horizontal (une ligne horizontale), tapez trois tirets d’affilée suivis d’une espace : Ex. : Saisissez --- pour créer un filet horizontal.

Astuce : si vous importez un fichier markdown, vous pouvez le faire découper en notes distinctes dans Agenda à l’aide de ces mêmes trois tirets d’affilée : Ex. : Première note --- Deuxième note

Cela créera deux notes différentes, la première avec le contenu « Première note », et la seconde avec le contenu « Deuxième note ».

Tableaux

Agenda vous permet d’insérer des tableaux dans vos notes, que vous pouvez créer rapidement en tapant trois symboles barre verticale (|) ou plus d’affilée en début de ligne : Ex. : Saisissez ||| pour insérer un tableau.

Liens

Les liens sont automatiquement reconnus dans le texte, mais vous pouvez aussi les ajouter avec la syntaxe markdown. Utilisez des crochets pour encadrer le texte affiché, suivis de parenthèses encadrant l’URL du lien. Ex. : Saisissez [Agenda](agenda.com) pour créer un lien vers agenda.com attaché au texte « Agenda ».

Actions de texte

Bien qu’elles ne fassent pas à proprement parler partie de la syntaxe markdown classique, Agenda permet de déclencher certaines actions si vous commencez par taper une barre oblique inverse , suivie d’une action.

Par exemple \remind déclenchera l’insertion d’un rappel dans votre note. Des paramètres facultatifs peuvent être fournis dans l’action ; ainsi, \remind(today at noon) programmera un rappel pour aujourd’hui à midi. D’autres actions courantes sont \now, \date et \time, qui insèrent la date et l’heure actuelles.

Pour un aperçu complet de toutes les actions, consultez le chapitre Aide-mémoire des actions de texte.

Les actions peuvent également servir d’espaces réservés dans les modèles ; voir le chapitre Créer et utiliser des modèles.

Empêcher l’interprétation du markdown

Même si les raccourcis markdown sont très pratiques et rapides, il y a des moments où vous ne souhaitez pas qu’un élément soit reconnu comme du markdown. Vous pouvez échapper les séquences markdown ci-dessus en tapant d’abord une barre oblique inverse \, suivie de ce que vous taperiez normalement. Dès que vous appuyez sur la barre d’espace, la barre oblique inverse devrait disparaître automatiquement et le texte rester tel que vous l’avez tapé. Par exemple, taper \1. Quelque chose ne produira pas de liste numérotée mais le texte 1. Quelque chose.

Notez que le markdown n’est jamais interprété dans un texte auquel est appliqué le style de paragraphe Préformaté ou le style en ligne Chasse fixe.