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 :
- Blocs de base — Texte, Titre 1–6, Liste à puces, Liste numérotée, Liste de tâches, Citation, Bloc de code, Tableau, Séparateur, Formule (LaTeX), Diagramme Mermaid
- Mise en forme — Gras, Italique, Barré, Code en ligne, Surlignage, Emoji
- Liens & médias — Lien, Lien interne, Image (web), Image interne, Intégration, Intégrer une base de données, Créer une base de données intégrée
- Document — Icône du document, Couleur d’en-tête, Insérer un modèle
- Callouts — 13 variantes (Note, Info, À faire, Résumé, Conseil, Succès, Question, Avertissement, Échec, Danger, Bug, Exemple, Citation)
Autres aides à l’écriture
- Barre d’outils de sélection — sélectionnez du texte et une petite barre propose Gras, Italique, Barré, Code en ligne, Surlignage et Lien.
- Mentions
@— tapez@n’importe où dans le texte pour insérer une Date (Aujourd’hui, Demain, Hier, ou Choisir une date…, stockée comme date ISO), un lien vers une Note, ou une intégration de Base de données. - Emoji — la commande slash Emoji (
/emoji) ouvre un sélecteur d’emoji à l’endroit du curseur ; ou tapez:name(par exemple:rocket) pour des suggestions en ligne. Dans les deux cas, Plainva insère le caractère emoji réel (Unicode portable), jamais un:shortcode:— la note reste ainsi lisible dans Obsidian, sur GitHub et partout ailleurs. (Ceci est distinct de l’icône du document de la note, qui est stockée dans le frontmatter.) - Poignées de bloc — une poignée apparaît à gauche de chaque paragraphe au survol : glissez-la pour déplacer le bloc, cliquez dessus pour ouvrir les Actions de bloc (Transformer en Texte/Titre/Liste/À faire/Citation/Bloc de code, Dupliquer, Monter/Descendre, Supprimer le bloc). Si vous glissez une liste à côté d’une autre liste du même type, Plainva insère une ligne de séparation invisible
<!-- -->pour que les deux listes restent distinctes — en Markdown, des listes de même style fusionneraient sinon malgré la ligne vide (aussi dans Obsidian). - Tableaux — rendus comme un widget avec des cellules éditables en un clic. L’affichage des cellules rend la mise en forme (gras, italique,
code, surlignage), les liens cliquables ([[Lien interne]], adresses web) et<br>comme un saut de ligne ; en édition, vous voyez le texte brut. Le menu du tableau propose l’insertion/suppression de lignes et de colonnes ainsi que l’alignement (Aligner à gauche/Centrer/Aligner à droite). - Les listes se poursuivent d’elles-mêmes (Entrée insère la marque de liste suivante), les blocs de code bénéficient d’une coloration syntaxique selon le langage (aussi en mode lecture), le contenu collé est converti en Markdown (collage intelligent), et les titres peuvent être repliés.
- Rechercher & remplacer dans la note actuelle :
Ctrl+F(voir Recherche).
Liens et backlinks
- Liens internes :
[[Nom de la note]](lien wiki) — via le menu slash ou@avec recherche de notes intégrée. Les liens Markdown classiques[texte](chemin.md)fonctionnent également. - Cibles qui n’existent pas encore : un lien wiki vers une note qui n’a pas encore été créée s’affiche atténué, avec un soulignement en tirets (aussi bien en aperçu en direct qu’en mode lecture). Cliquer dessus crée la note et l’ouvre — elle est placée dans le dossier de la note actuelle (ou au chemin indiqué si le lien en contient un, par exemple
[[Dossier/Nouvelle note]]). Pour être invité au préalable, activez Paramètres → App → Éditeur et notes → Demander avant de créer des liens vides. - Backlinks : la section Backlinks dans la barre latérale droite montre quelles notes renvoient à la note active — regroupées par fichier source, avec un compteur pour les occurrences multiples.
- Renommer avec soin des liens : quand vous renommez un fichier dans l’arborescence de fichiers, Plainva met à jour tous les liens qui pointent vers lui dans tout le vault (les ancres comme
#Sectionsont conservées) et signale : « N lien(s) dans M fichier(s) ont été mis à jour vers le nouveau nom. »
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 :
| Groupe | Types |
|---|---|
| Essentiels | Texte, Nombre, Case à cocher, Date, Date & heure |
| Choix | Sélection, Statut, Sélection multiple |
| Listes & relations | Liste, Tags, Relation |
| Web & contact | URL, 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 :
- En aperçu en direct, survolez au-dessus du titre : Ajouter une icône / Ajouter une couleur d’en-tête (plus tard : Changer l’icône / Changer la couleur d’en-tête) — ou utilisez les commandes slash Icône du document et Couleur d’en-tête.
- Le sélecteur d’icônes a deux modes — Emoji et Icônes — qui se manient de la même façon : une seule zone d’en-tête, une seule recherche, des catégories (onglets) dans les deux modes et une section Utilisés récemment qui survit à un redémarrage.
- Le jeu comprend environ 400 icônes sélectionnées en dix catégories (Savoir & fichiers, Travail & tâches, Technique, Personnes & contact, Création & médias, Quotidien & maison, Nature & météo, Voyages & lieux, Argent & chiffres, Symboles & états). La recherche porte sur les noms et les mots-clés.
- En mode icônes, tu choisis une couleur en haut — la même palette que la bande d’en-tête, A pour la couleur par défaut, Couleur personnalisée … pour une valeur libre. Elle s’applique à l’icône que tu choisis ensuite.
- Les deux sont stockés dans le frontmatter sous
plainva:(icon,icon_color,header_color) — pure présentation qui n’affecte pas les autres programmes.
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
-
Cases à cocher de tâches :
- [ ] tâchese rend comme une case à cocher partout — et en mode lecture, vous pouvez cliquer dessus : Plainva réécrit[x]ou[ ]dans le fichier. -
Formules mathématiques (LaTeX) :
$E = mc^2$en ligne et$$…$$en bloc se rendent comme des formules en mode lecture ET dans l’aperçu en direct (KaTeX). Quand le curseur se trouve dans une formule, la syntaxe est visible ; cliquer sur une formule rendue l’ouvre pour la modifier. Seul le mode source affiche toujours la syntaxe brute. Inutile de retenir par cœur le bloc$$…$$— la commande slash Formule (LaTeX) (/katex) l’insère et y place le curseur. -
Diagrammes Mermaid : un bloc de code avec le langage
mermaid(le plus rapide via la commande slash Diagramme Mermaid,/mermaid) se dessine comme un diagramme en mode lecture et dans l’aperçu en direct — cliquer sur le diagramme affiche le code pour le modifier :```mermaid graph TD Idea --> Note --> Knowledge ``` -
Notes de bas de page :
Texte[^1]plus[^1] : La note de bas de page.à la fin — le mode lecture rend la référence et l’appareil de notes avec des marques de saut. Le plus rapide est la commande slash Note de bas de page (/footnote) : elle insère la prochaine référence libre et saute directement dans la définition à la fin de la note.
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
- Exporter en Markdown… (menu ⋮ de l’éditeur ou palette de commandes) : enregistre une copie de la note n’importe où via la boîte de dialogue système — par exemple pour la transmettre à un autre programme. Les pièces jointes liées (images) ne sont pas copiées ; si la note en référence, Plainva affiche un bref avis.
- PDF : utilisez Imprimer / Enregistrer en PDF… (ci-dessus) et choisissez « Enregistrer en PDF » dans la boîte de dialogue système.
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
- Insérer : commandes slash Image interne (rechercher & intégrer depuis le vault) ou Image (web) (par URL). Vous pouvez aussi simplement coller un fichier depuis le presse-papiers (Ctrl+V) — une image comme un PDF ou un tableur. Et vous pouvez glisser des fichiers depuis l’explorateur de fichiers dans l’éditeur : les images s’intègrent (
![[…]]), les autres fichiers sont copiés et liés ([[…]]). L’endroit où ces fichiers atterrissent est un réglage : Paramètres → Votre coffre → Contenu et structure → Dossier des pièces jointes (par défautAttachments, avec un explorateur de dossiers). Laissez-le vide pour les garder à côté de la note, comme Plainva le faisait avant ce réglage. Le dossier voyage avec la synchronisation des paramètres : l’ordinateur et le téléphone classent donc les pièces jointes au même endroit. - Joindre un fichier… : la commande slash Joindre un fichier… et la même entrée dans le menu ⋮ de la note ouvrent la boîte de dialogue de fichiers de votre système ; sur le téléphone, elle se trouve dans la feuille + sous Fichier de l’appareil…. Le fichier est copié dans le dossier des pièces jointes — les images s’intègrent (
![[…]]), tout le reste est lié ([[…]]). - Lier : tapez
[[et Plainva propose d’abord les notes, puis en dessous, sous Pièces jointes, les fichiers de votre coffre. - Visualiser : les fichiers image (PNG, JPG, GIF, WebP, SVG, BMP, AVIF) s’ouvrent dans la visionneuse d’images intégrée avec Zoom avant/Zoom arrière, Ajuster et Taille réelle (1:1).
- Modifier : le bouton Modifier ouvre l’éditeur d’image avec Rogner, pivoter/retourner, Redimensionner, des outils de dessin (Crayon, Flèche, Rectangle, Texte) plus Annuler/Rétablir. Enregistrez sur place ou Enregistrer comme copie…. Les formats modifiables sont PNG, JPG et WebP ; les autres formats s’ouvrent en lecture seule.
- Les fichiers texte s’ouvrent dans Plainva :
.txt,.csv,.json,.yaml, le code source et similaires. Si votre coffre en demande davantage, ajoutez les extensions sous Paramètres → Votre coffre → Contenu et structure → Autres fichiers texte — la liste ne peut qu’ajouter, jamais retirer. Si le début du fichier révèle qu’il ne s’agit pas de texte, Plainva ne l’affiche pas et propose le programme par défaut : l’afficher et l’enregistrer l’endommagerait. Un fichier ouvert ainsi conserve ses fins de ligne et son BOM à l’enregistrement — il vous appartient, pas à Plainva. En édition, Plainva colore le texte selon l’extension du fichier — la même coloration syntaxique que reçoit un bloc de code dans une note. Les outils de note restent désactivés : pas d’aperçu en direct, pas d’en-tête de propriétés, pas de[[links]], pas de menu ”/”. Rechercher et remplacer reste, car c’est une fonctionnalité de texte et non une fonctionnalité de note. - Les autres pièces jointes s’ouvrent d’un simple clic dans le programme par défaut du système — dans l’arborescence comme via un
[[lien]], un signet ou la recherche.
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
- Bases de données (.base) — les notes en tableau, board ou calendrier
- OKF — ce que signifient
typeetokf_version - Recherche et Raccourcis clavier
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.