Notes & Markdown

Dernière mise à jour : 2026-08-14

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
okf_version: "0.1"
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).

Deux champs sont protégés : type et okf_version sont des champs système OKF gérés par Plainva — la valeur de type se choisit dans une liste déroulante de types connus, tandis que le nom/type de champ/suppression sont verrouillés (contexte : 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
{{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

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 notes quotidiennes configuré, éventuellement à partir d’un modèle.

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

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.