Notes & Markdown

Dernière mise à jour : 2026-09-30

Chaque note dans Plainva est un fichier Markdown ordinaire (.md). Cette page explique comment écrire confortablement et ce qui se retrouve réellement dans le fichier — car c’est exactement ce qui rend vos notes portables : n’importe quel éditeur de texte, Obsidian ou un diff git peut les lire.

Le principe fondamental : tout est texte

Tout ce que vous voyez dans Plainva — texte mis en forme, tableaux, propriétés, icônes — est stocké comme du texte ouvert :

---
type: Note
tags: [projet]
plainva:
  icon: "🚀"
  header_color: "#2f6f6f"
---
# Mon projet

Une pensée en **gras** avec un lien vers [[Autre note]].

- [ ] Première tâche

Le bloc entre les lignes --- est le frontmatter (YAML) : c’est là que résident les propriétés de la note. En dessous vient le texte Markdown normal. La présentation propre à Plainva (icône, couleur d’en-tête) est regroupée sous la seule clé plainva: — les autres programmes l’ignorent simplement.

Écrire en aperçu en direct

L’aperçu en direct est le mode par défaut : le Markdown se rend au fur et à mesure que vous tapez tout en restant modifiable à tout moment.

Le menu slash

Tapez / en début de ligne pour ouvrir le menu d’insertion. Il est organisé en sections :

Autres aides à l’écriture

Propriétés (frontmatter)

La section Propriétés dans la barre latérale droite montre le frontmatter de la note sous forme de formulaire. Ajouter une propriété en crée de nouvelles ; chaque propriété a un type de champ :

GroupeTypes
EssentielsTexte, Nombre, Case à cocher, Date, Date & heure
ChoixSélection, Statut, Sélection multiple
Listes & relationsListe, Tags, Relation
Web & contactURL, E-mail, Téléphone

Les types à choix peuvent porter des options fixes avec une Couleur et (pour Statut) un Groupe/une étape — ces listes d’options se gèrent dans les bases de données (.base), voir Bases de données (.base).

Sont protégés les champs système OKF gérés par Plainva : type (la valeur se choisit dans une liste déroulante de types connus, le nom/type de champ/la suppression sont verrouillés) et — là où d’anciennes notes le portent encore — okf_version (affichage seul ; depuis l’OKF 0.2, le champ n’a sa place que dans l’index.md racine). Contexte : OKF.

Statut, avis de péremption et marque de relecture (OKF 0.2)

Cinq propriétés facultatives de l’OKF 0.2 permettent à une note de dire d’où elle vient et si elle tient toujours — Plainva les affiche sans aucun réglage :

Plainva ne définit generated et sources que là où il crée les notes lui-même — dans l’importeur, dans la capture d’e-mails et dans la synchronisation des tâches ; l’éditeur ne tamponne jamais, et les notes existantes ne sont pas tamponnées après coup. Le contrat de champ se trouve dans la Référence du format de fichier, le contexte sous OKF.

Icône du document et couleur d’en-tête

Chaque note peut porter une icône (façon Notion au-dessus du titre, visible aussi dans les onglets et l’arborescence de fichiers) et une bande de couleur pleine largeur :

Modèles

Définissez un Dossier de modèles sous Paramètres → Vault → Contenu et structure (Choisir un dossier… à côté du champ permet de choisir le dossier directement dans le vault). Insérez ensuite des modèles via Ctrl+Alt+T ou la commande slash Insérer un modèle. Les modèles définissent entièrement le contenu des nouveaux fichiers — frontmatter compris : si un modèle apporte son propre type, le modèle l’emporte. Lors de l’insertion dans une note existante, le frontmatter du modèle est omis — seul le contenu est inséré.

Espaces réservés : les modèles remplissent des espaces réservés nommés — pas de scripts, pas d’expressions ; rien de tout cela n’exécute de code.

Espace réservéCe qu’il insère
{{title}}Le titre de la note
{{date}}, {{time}}La date et l’heure ; avec votre propre format : {{date:DD.MM.YYYY}}
{{date+7}}, {{date-1}}Une date décalée, combinable avec un format
{{yesterday}}, {{tomorrow}}La veille, le lendemain
{{weekday:monday}}, {{weekday:next friday}}Ce jour de la semaine, de la semaine en cours ou de la suivante ; un format suit un second deux-points : {{weekday:monday:DD.MM.}}. Le jour où la semaine commence dépend de votre paramètre de calendrier
{{daily}}, {{daily+1}}, {{daily-1}}Un lien vers la note quotidienne d’aujourd’hui, de demain ou d’hier ; avec votre propre libellé : {{daily+1:Demain}}
{{folder}}, {{vault}}Le dossier de la note, le nom du vault
{{cursor}}Aucun texte — indique où le curseur atterrit ensuite
{{prompt:Label}}, {{prompt:Label|Default}}Vous demande du texte (affiché comme Label)
{{select:Label|A,B,C}}Vous propose une liste de choix
{{date_prompt:Label}}Vous demande une date
{{selection}}Le texte sélectionné — lors de l’insertion d’un modèle
{{clipboard}}Le presse-papiers — il arrive comme une question pré-remplie, jamais discrètement dans la note
\{{date}}L’espace réservé lui-même, non résolu

Langue des dates : les noms de jours et de mois (dddd, MMMM) suivent la langue de l’application — dans une interface allemande, {{date:dddd, D. MMMM YYYY}} écrit donc Mittwoch, 29. Juli 2026. Le nom de fichier d’une note quotidienne reste volontairement en anglais : il doit correspondre au format qui l’a créé, sinon Plainva ne retrouve plus les notes quotidiennes existantes.

Quand un modèle demande quelque chose, Plainva pose toutes les questions dans une seule boîte de dialogue avant que la note soit écrite — que vous insériez ou créiez ; annuler ne crée rien. Seules les notes créées en arrière-plan (la synchronisation des tâches, par exemple) ne sont jamais interrogées : là, les réponses restent vides. Un espace réservé que Plainva ne connaît pas reste visible — ainsi, une faute de frappe ressemble à une faute de frappe.

Sur le téléphone, le même moteur fonctionne : les espaces réservés sont remplis, les questions d’un modèle arrivent ensemble dans une seule feuille (annuler ne crée rien), et les règles dossier → modèle et type de note → modèle s’y appliquent aussi — de sorte qu’une note dans Projekte/ démarre de la même façon sur les deux appareils. Deux différences : les règles sont définies sur le bureau (le téléphone se contente de les appliquer), et {{weekday:…}} y compte toujours à partir du lundi, car le réglage du premier jour de la semaine n’existe pas encore sur mobile.

Réglages propres au modèle : un modèle peut porter des réglages qui ne valent que pour lui — que ses tâches restent hors de la vue Tâches, ou les bases de données auxquelles il appartient. Une note créée à partir de lui n’en hérite pas. De très anciennes notes quotidiennes peuvent encore les porter ; la FAQ explique comment les retrouver.

Modèles par dossier : sous Paramètres → Vault → Contenu et structure → Modèles, vous associez un dossier à un modèle — chaque nouvelle note qui y est créée part alors de ce modèle, sans que vous ayez rien à choisir. L’association couvre aussi les sous-dossiers ; en cas de correspondances multiples, le chemin le plus long l’emporte (Projets/Clients l’emporte sur Projets). Vous associez un modèle à un type de note de la même façon ; il s’applique quand aucune règle de dossier ne couvre la note — le dossier l’emporte sur le type. Nouvelle note à partir d’un modèle … (clic droit dans l’arborescence de fichiers, la palette de commandes ou le sélecteur rapide) vous permet d’en choisir un explicitement — ce qui l’emporte sur toute association. Les associations vivent dans les paramètres, pas dans les notes, et voyagent vers vos autres appareils via la synchronisation des paramètres.

La création de modèles se fait depuis n’importe où : la palette de commandes (Ctrl+P) propose Créer un modèle (un nouveau modèle s’ouvre pour être modifié) et Enregistrer la note actuelle comme modèle (copie la note ouverte dans le dossier de modèles). Les modèles sont des fichiers Markdown ordinaires — modifiez-les, renommez-les ou supprimez-les directement dans l’arborescence de fichiers.

Notes quotidiennes

Ouvrir la note quotidienne (barre latérale) ou un clic dans le Calendrier crée la note du jour selon votre format de date dans le dossier de base des notes quotidiennes configuré, éventuellement à partir d’un modèle.

Une note quotidienne peut aussi contenir un journal : de courtes entrées avec une heure (- 14:05 Texte) sous le titre Journal, écrites avec Ctrl+Shift+J ou Entrée de journal, et lues sur tous les jours dans la vue du journal. Ce sont de simples lignes de liste — voir Journal.

Tâches, formules, diagrammes et notes de bas de page

Texte de droite à gauche

L’arabe, l’hébreu, le persan et les autres écritures de droite à gauche sont composés automatiquement de droite à gauche — paragraphe par paragraphe, sans réglage à activer. Chaque paragraphe, titre, élément de liste, ligne de citation et cellule de tableau suit sa première lettre après la syntaxe Markdown : un paragraphe qui commence par un mot arabe part de la droite, un paragraphe qui commence par un mot latin part de la gauche, et une même note peut mélanger les deux. Puces, cases à cocher, barre de citation et retrait passent à droite avec le texte ; le x de - [x] ne compte pas comme un mot, une tâche terminée reste donc à droite. Une ligne sans lettre (un nombre, un nouvel élément de liste vide) garde la direction de la ligne au-dessus.

Imprimer et enregistrer en PDF

Le menu ⋮ de l’éditeur et la palette de commandes (Ctrl+P) proposent Imprimer / Enregistrer en PDF… : l’impression utilise toujours la vue de lecture (depuis l’aperçu en direct/source, Plainva y bascule d’abord). Dans la boîte de dialogue système, vous pouvez choisir « Enregistrer en PDF » au lieu d’une imprimante.

Exporter une note

Ouvrir une note dans un autre éditeur

Vos notes sont de simples fichiers .md, donc n’importe quel éditeur Markdown peut les ouvrir. Le menu ⋮ de l’éditeur propose Ouvrir dans l’application par défaut, qui transmet la note actuelle au programme que votre système utilise pour les fichiers Markdown (Byword, MacDown, VS Code, etc.). Plainva continue de surveiller le fichier, donc les modifications que vous y apportez apparaissent ici automatiquement.

Images et pièces jointes

Et Obsidian ?

Tout reste du Markdown standard avec un frontmatter standard. Obsidian ouvre les fichiers entièrement ; il affiche la clé regroupée plainva: comme un objet non modifiable dans son panneau de propriétés — c’est voulu et sans conséquence.

Voir aussi

Mise en forme d’une sélection

Quand une sélection couvre plusieurs lignes, le gras, l’italique, le barré, le surlignage et le code en ligne sont appliqués séparément à chaque ligne non vide. Les préfixes de liste, citation, titre et tâche restent hors des marqueurs. Les liens restent sur une seule ligne, car un libellé de lien multiligne n’est pas un Markdown portable.

Un titre ATX et une tâche GFM sont deux types de blocs alternatifs. Plainva n’écrit donc pas de combinaison invalide. La mise en forme en ligne reste disponible dans les deux blocs ; utilisez - [ ] **Tâche importante** pour mettre un titre de tâche en évidence.

Inclure des sections et des blocs

![[Note#Titre]] affiche la section et ses sous-titres jusqu’au prochain titre de niveau égal ou supérieur. ![[Note#^block-id]] affiche le paragraphe, l’élément de liste ou le bloc précédant un identifiant placé seul sur une ligne. Le lien normal [[Note#^block-id]] y mène aussi en mode lecture.

Pour les titres répétés, utilise une hiérarchie unique (#Projet#Résultat) ou une ancre numérotée (#résultat-1). Les cibles absentes ou ambiguës affichent un message et la source reste accessible. L’imbrication est limitée ; les exemples de code n’exécutent pas d’inclusions. Sur le téléphone, les sections et blocs ne sont pas tronqués aux quatre lignes de l’aperçu général. Les fichiers existants restent inchangés.

Utiliser les listes

Un élément de liste se replie uniquement après un appui ou un clic terminé sur sa puce. Un glissement, un défilement, un contact annulé ou un geste à plusieurs doigts ne le replie pas. Le retrait reste stable lors des changements de police et dans les fenêtres étroites ; le texte source, les tabulations et la position du curseur sont conservés.

Barres de sélection visibles

La barre de mise en forme suit la sélection pendant le défilement et garde une marge avec les bords de l’écran. Si l’espace manque, elle change de côté ou répartit ses boutons sur plusieurs lignes. En lecture mobile, les libellés longs deviennent si nécessaire des icônes avec des noms accessibles ; Copier, Tout sélectionner et les actions de modification ou de commentaire disponibles restent accessibles.

Compléter les propriétés

À l’ajout, les noms connus affichent leur type et leur fréquence. Les noms déjà présents et réservés sont exclus. Le type de la base concernée est prioritaire, puis celui de l’index et du registre local. Les suggestions de texte et de listes viennent du dossier de la note ; « Rechercher dans tout le coffre » élargit la recherche. Les listes proposent chaque valeur séparément. Les options définies par la base restent exclusives, même si leur liste est vide. La saisie libre reste possible ; seule une modification confirmée change la note. Textes et listes conservent leur type, dans les propriétés et les cellules de base, sur ordinateur et mobile.

Ouvrir l’image

Ouvrir l’image est disponible pour les images locales en lecture, en aperçu et dans le menu contextuel. Le visualiseur mobile propose le zoom à deux doigts, le double appui et les boutons ; Réinitialiser le zoom affiche toute l’image. Retour ramène à la note. L’appui long conserve les actions du système et les régions d’image restent commentables.