Le guide

Tout ce que fait l'application, dans l'ordre où vous le rencontrerez probablement. Il décrit l'application telle qu'elle est aujourd'hui : là où quelque chose manque délibérément, il le dit plutôt que de vous laisser le chercher.

Les coffres : où vivent vos notes

Un coffre est un dossier dans votre propre stockage : Google Drive, OneDrive, ou un dossier dans un canal Teams sur un compte professionnel. Pergalino lit et écrit les fichiers qui s'y trouvent et ne garde rien à lui ailleurs. Effacez l'application de votre vie et le dossier est exactement ce qu'il était : des fichiers .md, des images, des PDF.

Pour en ajouter un : Réglages → Coffres, ou depuis la barre latérale quand aucun n'est ouvert. Google Drive ouvre le sélecteur de Google ; OneDrive ouvre un explorateur de dossiers. Plusieurs coffres peuvent être ouverts en même temps, de l'un ou l'autre service, et ils apparaissent comme des arborescences distinctes dans une seule barre latérale avec un seul champ de recherche pour tous.

Chaque coffre garde ses propres réglages dans un dossier caché .drivenote qu'il contient : le vocabulaire des propriétés, les couleurs de fichiers, les favoris, et les fichiers qui étaient ouverts. C'est ce qui rend un coffre transportable d'un appareil à l'autre, et c'est pourquoi rien d'un coffre n'est écrit dans un autre. Réglages → Coffres contient aussi Relire (relire le dossier depuis le début), Vérifier la portée (ce que l'application a réellement le droit de voir) et Retirer de la barre latérale, qui cesse d'afficher un dossier et ne touche à rien dans votre stockage.

La fenêtre

Deux barres latérales autour des notes. Chacune contient des panneaux que vous pouvez faire glisser de l'une à l'autre, et chaque panneau est un onglet : Fichiers, Récents, Recherche, Favoris, Toutes les propriétés, Tags, Tâches, Historique et Graphe. La disposition est mémorisée par appareil. Les propriétés d'une note et ses connexions ne sont pas des panneaux : elles se déplient au-dessus et au-dessous du texte, là où est la note.

• Onglets et volets. Chaque fichier ouvert est un onglet ; faites-en glisser un vers le bord de l'éditeur pour scinder, et un volet scindé peut avoir ses propres onglets. Un onglet s'épingle depuis son menu contextuel ou par un double-clic, et un onglet épinglé survit à toute fermeture qui ne le nomme pas.
• Seuls les derniers fichiers restent ouverts. Dix par défaut, réglable dans Réglages → Disposition. Rien de non enregistré, d'épinglé ou de visible n'est jamais fermé à cause de la limite, et le panneau Récents est le chemin de retour vers ce qui l'a été.
• Reculer et avancer parcourent le chemin que vous avez pris — les deux flèches de l'en-tête, Mod+[ et Mod+], ou la barre du bas sur un téléphone. Récents répond à l'autre question : qu'est-ce qui a été ouvert dernièrement.

Écrire

Les notes sont en Markdown. L'éditeur a deux modes, échangés dans la barre de la note : l'aperçu en direct, où titres, gras, liens, tableaux, encadrés et lignes de tâches s'affichent à mesure que vous tapez et où la syntaxe se cache sur les lignes où vous n'êtes pas ; et le Markdown, c'est-à-dire le fichier exactement tel qu'il est sur le disque, avec les numéros de ligne. Rien n'est inventé dans l'un ni dans l'autre : ce que vous écrivez est ce que contient le fichier.

• La barre de format flotte au-dessus d'une sélection et s'ancre au-dessus du clavier sur un téléphone : gras, italique, titres, listes, citations, code, surlignage, tâches, et l'appareil photo.
• Les liens s'écrivent dans une boîte de dialogue, par Mod+K ou le bouton ↗ de la barre, pré-remplie avec ce dans quoi se trouve le curseur. Cliquer sur un lien l'ouvre ; en mode Markdown cela demande Ctrl/Cmd, car là le texte est la source que vous êtes venu modifier.
• Tableaux, encadrés et blocs de code s'affichent dans l'aperçu en direct, le code avec la coloration de son propre langage. ==surlignage== marche aussi, ce qui n'est ni du CommonMark ni du Markdown GitHub, mais ce qu'écrivent les autres applications de notes.
• Coller depuis une page web conserve la mise en forme, convertie en Markdown. Mod+Shift+V colle du texte brut, et Réglages → Éditeur échange lequel des deux est le comportement par défaut.
• Une note peut être verrouillée contre la frappe en mettant readonly: true dans ses propriétés. L'enregistrement et le bloc de propriétés restent ouverts, pour que vous puissiez toujours la déverrouiller : un verrou dont la clé ne fonctionne pas est un piège, pas un verrou.

Liens, tags et intégrations

• Les [[wikiliens]] se complètent à la frappe, sur les notes et les fichiers : un tableur ou un PDF lié s'ouvre comme une note. Un lien vers quelque chose qui n'existe pas encore est signalé, et le panneau des connexions propose de le créer.
• Rétroliens et presque-liens. Sous chaque note : ce qui pointe ici, puis les liens que vous avez failli faire — les liens dans le vide, les mentions non liées montrées avec leur phrase, et les notes que le graphe rapproche.
• Les #tags sont des pastilles dans le texte et dans le bloc de propriétés. Taper # complète à partir des tags que le coffre utilise déjà, et c'est ainsi que #Energie et #energie cessent de devenir deux tags. Cliquer sur l'un lance la recherche. Le panneau Tags les liste tous avec leurs comptes, tags imbriqués compris.
• Intégrations. ![[Note]] affiche cette note dans celle-ci ; ![[Feuille]] affiche un fichier Google dans son propre cadre ; un PDF s'affiche comme une page. Écrivez !-[[Note]] et la carte démarre repliée — l'état est dans le texte, donc il voyage avec la note. Les cases à cocher d'une carte se cochent, et Modifier sur la carte vous donne le vrai éditeur sans quitter la page.

Fichiers, dossiers et pièces jointes

• L'arborescence est le dossier. Clic droit sur une ligne (appui long sur un téléphone, ou le bouton ⋯ dessus) pour Nouvelle note, Nouveau dossier, Nouveau tableau, Nouvelle liste, Numériser un document, Renommer, Déplacer vers un dossier, couleur, et Mettre à la corbeille. Le chevron à gauche d'un dossier l'ouvre et le ferme.
• Notes de dossier. Une note qui porte le nom de son dossier — Maison/Maison.md — est la page de ce dossier : cliquer sur le dossier l'ouvre, et un point dans l'arborescence dit qu'elle existe. Rien n'est enregistré pour que cela marche ; le nom est tout le mécanisme, donc Obsidian et Drive voient la même chose.
• Couleurs. Colorez une ligne depuis son menu, ou écrivez des règles dans Réglages → Fichiers : par nom, par chemin, ou par type de fichier, la première règle qui correspond gagne. Les règles vivent dans le coffre, donc elles suivent les notes jusqu'à vos autres appareils.
• Pièces jointes. Déposez ou collez un fichier dans une note, ou utilisez /attach. Il est téléversé dans le coffre — dans _attachments à côté de la note par défaut, configurable par coffre — et le lien est écrit pour vous. Les images et les PDF s'affichent sur place.
• Déplacer et jeter emportent les pièces jointes. Déplacer vers un dossier propose d'emmener les fichiers propres à la note et réécrit les liens dans les deux cas ; la corbeille propose la même chose. Un fichier vers lequel deux notes pointent n'appartient à aucune des deux, donc on n'y touche pas.
• Fusionner des images en un PDF. Sélectionnez plusieurs images dans l'arborescence, clic droit, et elles deviennent un seul PDF dans l'ordre que vous fixez. Les originaux restent où ils sont.

Numériser du papier

/scan dans une note, l'appareil photo sur la barre de format du téléphone, ou Numériser un document sur un dossier. La caméra trouve la page, la détoure, et déclenche elle-même dès que le contour ne bouge plus ; les coins se déplacent si elle s'est trompée. Plusieurs pages deviennent un seul PDF, ou une image par page — les deux sont proposés sur l'écran de revue, et les pages s'y réordonnent.

Le nom vient du papier : la première page est lue par la reconnaissance de texte de Drive et le fichier prend le nom de la ligne qui ressemble à un titre, à défaut la date. Ce qu'une numérisation écrit dans la note est une intégration, donc c'est la page qui s'affiche et non le nom du fichier.

Gmail : les e-mails comme notes

Un libellé Gmail peut être une entrée dans le coffre. Donnez le libellé Pergalino à une conversation et elle devient une note dans le dossier de réception du coffre ; rangez la note et le libellé suit. La synchronisation est désactivée tant que vous ne l'activez pas, elle appartient à un seul coffre, et elle ne supprime, n'envoie ni n'archive jamais rien dans Gmail.

L'activer : Réglages → Gmail, choisissez le coffre, activez. La première fois, l'application vous demande d'autoriser l'accès à Gmail ; Google affiche son écran une fois, et la synchronisation démarre dès votre retour. Le libellé surveillé est Pergalino, sauf si vous y choisissez un autre nom.

• Une conversation avec le libellé Pergalino apparaît dans le dossier de réception, celui que Réglages → Fichiers appelle le dossier des nouvelles notes. Une conversation avec Pergalino/Domaines/Cuisine va directement dans Domaines/Cuisine, et le dossier est créé s'il manque. La note contient l'objet, l'expéditeur, chaque message en section et un lien vers la conversation dans Gmail ; les pièces jointes sont enregistrées dans le dossier des pièces jointes et liées.
• Déplacer la note déplace le libellé : glissez-la dans Domaines/Cuisine et la conversation porte Pergalino/Domaines/Cuisine dans Gmail, les libellés parents étant créés pour que Gmail les affiche imbriqués. De retour dans la réception, c'est de nouveau simplement Pergalino. Peu importe où le déplacement a lieu : dans l'application, sur un autre appareil ou dans Drive. Si la conversation a aussi changé de libellé dans Gmail entre-temps, Gmail l'emporte.
• Les réponses s'ajoutent à la fin de la note, une seule fois chacune, sous ce que vous y avez écrit. L'historique cité que chaque réponse traîne avec elle est omis, puisque les messages précédents y sont déjà.
• Mettre la note à la corbeille retire les libellés Pergalino de la conversation et laisse l'e-mail tranquille. Retirer le libellé dans Gmail arrête la synchronisation de cette conversation et laisse la note tranquille.
• Renommer le libellé dans les Réglages le renomme aussi dans Gmail, avec tous les libellés en dessous, si bien que chaque conversation garde son dossier.
• La fréquence se règle dans Réglages → Gmail → Intervalle de synchronisation : chaque minute, toutes les 5 ou 15 minutes, chaque heure, ou seulement avec Synchroniser. Chaque passage figure dans Réglages → Activité, et ceux qui ont changé quelque chose disent quoi.

Propriétés

Le bloc au-dessus de chaque note est son frontmatter, montré en lignes plutôt qu'en YAML. Drive fournit créé et modifié ; tout le reste est à vous.

• Le coffre a un vocabulaire. Les noms sont déclarés une fois dans Réglages → Propriétés, et une note y puise. C'est ce qui empêche une note de dire due, la suivante Date d'échéance et une troisième deadline, sans que rien ne s'en aperçoive. C'est proposé, jamais imposé : une note qui porte déjà un nom non déclaré le garde.
• Sept sortes, chacune choisie parce qu'elle est un contrôle différent et non une règle de validation différente : texte, nombre, case à cocher, choix unique, choix multiple, et deux qui prennent leurs options dans un dossier — une note tirée de Personnes, ou plusieurs. Une valeur issue d'un dossier est écrite comme un [[lien]], donc elle apparaît dans les rétroliens et dans le graphe.
• Deux propriétés viennent de l'application et sont proposées dans chaque coffre : view, qui dessine la note en tableau ou en liste, et readonly, qui verrouille son texte. Elles portent la mention app dans le sélecteur, et dès que votre coffre en déclare une lui-même, elle est à vous.
• Toutes les propriétés, dans la barre latérale, liste chaque nom que le coffre utilise réellement, avec les comptes, et propose d'adopter ceux que personne n'a déclarés.

Tâches

Une tâche est une ligne : - [ ] Appeler Hans. Pergalino la dessine comme une carte et vous laisse ajouter le reste en pointant, mais ce qu'il écrit est le même texte brut que lit le plugin Tasks d'Obsidian — une échéance s'écrit 📅 2026-05-15, une priorité est une flèche, et rien n'est stocké ailleurs.

• Sur une ligne de tâche, @ choisit une date, ! une priorité et % un statut ; /due, /priority et /status font de même depuis n'importe où. Le champ de date comprend aujourd'hui, vendredi, dans 3 jours, 3d, +2w, semaine prochaine, fin de mois, 15.9 et un simple 25 pour un jour de ce mois.
• Entrée poursuit la liste avec une case neuve, quel que soit le statut de la ligne du dessus, et une nouvelle tâche atterrit après tout ce qui pend sous la tâche courante. Maj+Entrée écrit une ligne de description : les lignes indentées sous une tâche sont son propre texte, ce que Markdown veut déjà dire par là.
• Les statuts sont les quatre que connaît le dialecte : à faire, fait, [/] en cours et [-] annulé. Cocher une case y inscrit la date d'achèvement exactement comme le sélecteur.
• Le panneau Tâches rassemble chaque tâche de chaque coffre ouvert, groupée par échéance, priorité, note, section, tag ou statut, avec un champ de filtre qui cherche dans la description et dans le texte en dessous. Une ligne ouvre la note à l'endroit voulu ; on coche dans la note, là où vivent l'enregistrement et la fusion.
• Masquer les tâches terminées, dans le menu de la note, replie celles qui sont finies hors de la vue sans toucher au fichier.

Tableaux

Un tableau est une note avec view: kanban dans ses propriétés, plus group: et filter:. Il dessine d'autres notes comme des cartes en colonnes. Enlevez les clés et c'est de nouveau une note.

• Les colonnes sont les options déclarées d'une propriété — le vocabulaire, et non les valeurs qui se trouvent exister — avec une colonne pour les notes sans valeur et une pour les valeurs que personne n'a déclarées. group: folder groupe plutôt par le dossier où se trouve chaque note, et là un dépôt déplace le fichier.
• Le filtre est le langage de recherche, le même que celui du champ de recherche. Créé depuis le menu contextuel d'un dossier, un tableau démarre filtré sur ce dossier.
• Les cartes peuvent porter des propriétés et un aperçu — cardProperties: [due, owner] et cardPreview: none|small|medium|large. Les cartes sont dans l'ordre des noms ; un tableau est une vue sur des notes qui relèvent du classement de quelqu'un d'autre, donc il n'y a pas de tri manuel à conserver.
• Un dépôt écrit la note de la carte elle-même. Il relit la note d'abord, refuse celle qui est ouverte avec des modifications non enregistrées, et réindexe ensuite.

Listes et listes de courses

view: checklist dessine les mêmes lignes - [ ] en liste dense plutôt qu'en cartes de tâches : pas d'échéances, pas de boutons de priorité, les articles achetés estompés et barrés. Nouvelle liste sur un dossier l'écrit pour vous.

• Taper un article propose ceux que vous avez déjà utilisés, les plus fréquents d'abord, moins ce qui est déjà sur la liste. Le vocabulaire est gardé dans le coffre et non dans la note, donc la liste de la semaine prochaine part en sachant tout et celle de la semaine passée peut être jetée.
• Elle se remplit toute seule. Enregistrer une liste ajoute ses articles ; en cocher un le compte, et c'est ce qui ordonne les propositions. Deux façons d'écrire une même chose sont regroupées, quantité en tête comprise : 2 lait et lait sont un seul article.
• Réglages → Listes montre tout le vocabulaire par coffre avec ses comptes, et supprime un article qui ne doit plus être proposé. On ne peut rien y ajouter : un article gagne sa place en étant écrit sur une liste.
• Une deuxième liste garde ses propres mots. Ajoutez list: packing à côté de la vue et cette note puise dans son propre vocabulaire, si bien qu'un passeport n'est jamais proposé au supermarché.
• Les articles de liste restent hors du panneau Tâches. « Lait » n'est pas une tâche ouverte au sens où ce panneau pose la question.

Retrouver ses affaires

• La recherche couvre le titre, le chemin, le corps et les tags de chaque note de chaque coffre ouvert, et le dernier mot tapé correspond par préfixe. Cliquer sur un résultat saute à la ligne et la fait clignoter.
• Le langage de requête : "une expression exacte", tag:home (tags imbriqués compris), path:Projets/, property:status pour les notes qui en ont une tout court, property:status=draft pour une valeur, prop: comme forme courte, et -exclusion pour écarter des résultats.
• La palette de commandes est Mod+Shift+P — ou un geste vers le bas depuis le haut de l'écran sur un téléphone. Tout ce que l'application sait faire s'y trouve, avec son raccourci à côté. Mod+P est la question plus courte : ouvrir un fichier par son nom.
• Le graphe dessine tout le coffre, dans un panneau latéral ou en travers du milieu. Il se stabilise puis s'arrête, si bien qu'un graphe laissé ouvert ne tient pas un téléphone au chaud.
• Les favoris sont des fichiers étoilés, gardés dans le coffre, donc ils vous suivent d'un appareil à l'autre.

Enregistrement, synchronisation et historique

• Enregistrer se fait avec Mod+S, ou automatiquement peu après que vous cessez de taper si vous activez l'enregistrement automatique dans Réglages → Éditeur. Un onglet avec du travail non enregistré porte un point et ne peut pas se fermer par accident.
• Les modifications de vos autres appareils arrivent d'elles-mêmes. Une note propre est rechargée ; une note que vous êtes en train de modifier est fusionnée, et seul un vrai chevauchement s'arrête pour demander — Voir les deux, Garder la mienne, ou Prendre la leur. Rien n'écrase un brouillon de son propre chef.
• L'historique des versions, dans la barre latérale droite, liste les révisions du fichier telles que votre stockage les conserve, montre une comparaison et en restaure une. C'est l'historique du fournisseur, pas une copie que cette application garde.
• Hors ligne, un coffre déjà lu reste lisible et cherchable, et l'application elle-même démarre depuis son cache. Les écritures attendent le réseau.
• Ce que l'application est en train de faire est dans la barre d'état, et sur un téléphone dans la barre de la note tant que cela dure. Réglages → Activité liste tout ce qui tourne en ce moment, ce qui a tourné depuis l'ouverture de l'onglet, et chaque exécution qui a changé quelque chose ou échoué.

Sur un téléphone

Ajoutez le site à l'écran d'accueil et il se comporte comme une application : il démarre depuis son propre cache, garde son propre stockage, et n'a pas d'habillage de navigateur. La disposition change avec l'écran plutôt qu'avec la largeur de la fenêtre, et Réglages → Disposition peut passer outre.

• Avec une note ouverte, il y a une barre flottante à chaque extrémité au lieu d'un en-tête, d'une barre de note et d'une barre d'état. Les deux s'effacent quand vous faites défiler vers le bas et reviennent au moindre mouvement vers le haut — et elles restent en place tant que l'application travaille, si bien qu'une longue lecture de coffre n'est jamais invisible.
• Les panneaux latéraux sont des tiroirs par-dessus la note ; les deux boutons de la barre de note les ouvrent. Un document à la fois, donc il n'y a pas de barre d'onglets : le compte dans la barre du bas ouvre la liste de ce qui est ouvert, avec les marques de non-enregistré.
• L'appui long est le clic droit, et chaque ligne porte aussi un bouton ⋯. Les menus s'ouvrent en feuille depuis le bas de l'écran.

Réglages

Deux portées, et la différence est délibérée. Les réglages d'appareil — thème, taille du texte, largeur de ligne, mode d'affichage, enregistrement automatique, intervalle d'interrogation, raccourcis — concernent l'écran devant lequel vous êtes, et chaque appareil garde les siens. Les réglages de coffre — vocabulaire des propriétés, couleurs de fichiers, dossier des pièces jointes, favoris, mots des listes — concernent les notes, donc ils voyagent avec elles.

• Apparence — thème, taille du texte de l'éditeur, largeur de ligne.
• Éditeur — mode d'affichage, enregistrement automatique et son délai, format de collage.
• Coffres — en ajouter un, relire, vérifier la portée, retirer.
• Propriétés — le vocabulaire du coffre et ses types.
• Fichiers — ordre de tri, règles de couleur, dossier des pièces jointes, où atterrit une nouvelle note.
• Gmail : si un libellé Gmail alimente ce coffre, lequel, et à quelle fréquence.
• Listes — les mots que chaque liste propose.
• Synchronisation — à quelle fréquence demander les changements, et quel compte est connecté.
• Disposition — quelle forme dessiner, combien de fichiers restent ouverts, si les blocs au-dessus et au-dessous d'une note démarrent repliés.
• Raccourcis — chaque attribution, et celles que vous avez changées.
• Stockage — ce qui est gardé dans ce navigateur, avec le moyen d'effacer chaque chose.
• Activité — ce qui tourne et ce qui a tourné.
• À propos — la version, les téléchargements de bureau, et un rechargement qui vide tous les caches.

Raccourcis clavier

Mod est Cmd sur un Mac et Ctrl ailleurs. Chacun d'eux se change dans Réglages → Raccourcis, et la palette de commandes montre l'attribution actuelle à côté de chaque commande.

• Mod+Shift+P — palette de commandes
• Mod+P — ouvrir un fichier par son nom
• Mod+Shift+F — chercher dans toutes les notes
• Mod+, — réglages
• Mod+S — enregistrer
• Mod+[ et Mod+] — reculer et avancer
• Mod+B et Mod+Alt+B — les barres latérales gauche et droite
• Mod+G — le graphe
• Mod+1, Mod+2 — titre 1, titre 2
• Dans l'éditeur: Mod+B, Mod+I, Mod+E — gras, italique, code
• Mod+K dans l'éditeur — écrire un lien
• Mod+Shift+V — coller dans l'autre sens
• [[, #, / — compléter un lien, un tag, une commande
• @, !, % sur une ligne de tâche — échéance, priorité, statut
• Esc — ferme ce qui est ouvert par-dessus la note

Limites à connaître

• L'accès anticipé est sur invitation, et l'écran de consentement de Google est en mode Test tant que l'application demande la portée Drive complète. Cela veut dire que tout le monde réapprouve environ une fois par semaine, en une pression, et que chaque utilisateur doit être ajouté à la main.
• Les fichiers Google appartiennent à Google. Un Doc ou une Feuille est encadré depuis Drive et modifié là-bas ; rien n'est converti. L'application de bureau est l'exception : le cadre y est modifiable sur place.
• Les applications de bureau sont macOS sur Apple Silicon et Windows 64 bits. Pas de version Mac Intel, pas de version Linux, et un iPad se présente comme un Mac et ne peut rien exécuter de tout cela — là, ajoutez le site à l'écran d'accueil.
• Un coffre est lu une fois avant que la recherche soit complète. Sur quelques milliers de notes cela prend un moment au premier tour ; l'application dit où elle en est, et la recherche le dit aussi plutôt que de prétendre qu'il n'y a rien à trouver.
• La synchronisation Gmail tourne tant que l'application est ouverte. Aucun serveur ne lit vos e-mails en arrière-plan : un libellé posé pendant que tous les appareils sont fermés est pris en compte la prochaine fois que l'un d'eux ouvre Pergalino.

Si quelque chose ici ne correspond pas à ce que vous voyez, c'est l'application qui a raison et cette page qui est en retard : dites-le et ce sera corrigé.