Markdown et wikilinks

Modes d'affichage

Les notes .md s'ouvrent avec l'éditeur et la lecture côte à côte (configurable). Le balisage est atténué en dehors du paragraphe du curseur pour que la page ressemble à un document fini.

Raccourcis : Ctrl+B/Ctrl+I appliquent gras/italique et Ctrl+E fait défiler le mode d'affichage (édition → partagé → mise en forme → lecture).

Le menu / : dans l'éditeur formaté, tapez / en début de ligne (l'indentation est admise) ou après une espace : la liste d'insertion s'ouvre au curseur. Tapez pour filtrer (/table, /encadré, /h1), choisissez avec ↑/↓ et insérez avec Entrée ; Échap ou Espace ferment la liste et ce que vous avez tapé reste sous forme de texte. La colonne de droite montre le balisage écrit par chaque entrée, pour que vous puissiez le taper directement la prochaine fois. Le menu ne s'ouvre pas dans un bloc de code, une formule ou une cellule de tableau.

Mode lecture : le dernier mode de Ctrl+E est le même écran que l'édition mise en forme, mais en lecture seule — c'est pourquoi il peut afficher ce que le fichier ne contient pas : le sommaire du jeton [TOC]. La liste du dossier du jeton [files] et le corps des notes transcluses avec ![[note]] apparaissent aussi dans l'édition mise en forme. Rien de tout cela n'est écrit dans le .md : le fichier conserve le jeton, et le texte généré n'accepte pas la modification. Dans ce mode, un simple clic suit les liens, les wikiliens et les étiquettes (sans Ctrl), et les boutons d'édition sont désactivés — y compris annuler, couper et coller, qui agissaient auparavant sur l'éditeur de texte hors écran. Copier reste actif et copie ce que vous voyez. Ctrl+F cherche dans ce qui est à l'écran ; la ligne remplacer est désactivée, avec le motif dans l'infobulle, car un remplacement ici n'arriverait jamais au fichier.

Des calculs avec unité, en lecture. Une ligne finissant par = reçoit le résultat : 3,5 km / 2 s = apparaît comme 3,5 km / 2 s = 1,75 km/s. Le fichier ne change pas — même idée que le [TOC] et la citation mise en forme. Elle fait l'analyse dimensionnelle, et c'est ce qui la justifie : 1 km + 1 s = est refusé en nommant les deux, car une calculatrice qui répondrait 2 là ne serait pas pire : elle mentirait, et dans un cahier de laboratoire l'erreur survivrait jusqu'à l'article. Additionner la même grandeur en unités différentes fonctionne et convertit (2 h + 30 min =), et le résultat sort dans l'unité que vous avez écrite. Elle connaît les préfixes du SI, les constantes physiques (c, h, k_B, N_A, g…), la conversion explicite (3 km in m, aussi to et ->) et l'incertitude : (2,00 ± 0,05) m / (1,0 ± 0,1) s = propage l'erreur et n'écrit que les chiffres que la mesure permet. Le code et les formules restent dehors — dans une clôture ```, entre accents graves ou dans un $…$, le = de fin de ligne est la syntaxe d'autre chose. Et une ligne qui n'est pas un calcul (Total =) reste telle quelle, en silence.

Elle est désactivée : activez-la dans Paramètres → Fonctions → Académique → Calculatrice avec unités.

Cartes en répétition espacée. Une note qui reçoit l'étiquette #flashcards devient un paquet : à l'intérieur, chaque ligne Question::Réponse est une carte, ::: crée aussi la carte inverse, un ? seul entre deux lignes fait la carte multiligne, et ==comme ça== devient un trou. Sans l'étiquette, aucune note n'a de cartes — c'est ce qui empêche un std::vector d'une note de programmation de devenir une carte que vous n'avez pas écrite. Outils → Cartes → Réviser les cartes ouvre la session : la réponse reste cachée jusqu'à ce que vous la demandiez (c'est tout le principe — voir les deux ensemble, c'est relire, et relire ne fixe rien), et les quatre notes portent écrit dessus combien de temps chacune achète. La planification est le FSRS, l'algorithme d'Anki.

L'identité d'une carte est sa QUESTION : corriger la réponse ne touche pas à la planification, et réécrire la question met cette carte à la retraite et en commence une autre — ce qui est juste, car la question est ce que vous apprenez. L'historique vit dans un fichier ouvert à côté de la note (note.md.cards.ndjson) : versionnable avec Git et lisible dans n'importe quel éditeur, au prix d'un fichier de plus dans le dossier. Exporter vers Anki écrit le fichier texte qu'il importe — la planification ne suit pas, car l'importateur de texte d'Anki ne l'accepte pas ; elle reste dans les .ndjson.

Blocs de code

Le bloc de code ressort en couleur. Une clôture avec le langage déclaré (```python) voit son contenu coloré jeton par jeton, avec les mêmes couleurs que l'éditeur de code — y compris le thème de code choisi pour cette fenêtre. Cela vaut dans l'édition formatée, le mode lecture, le fichier exporté et les réponses de Interroger les notes. Une clôture sans langage déclaré reste monochrome, et un langage sans coloration disponible aussi : le texte ne disparaît jamais.

Replier, épingler et exporter

Replier des sections et épingler le titre valent aussi en mode formaté et en lecture. Ctrl+Shift+[ replie la section du curseur et Ctrl+Shift+] la déplie ; cliquer sur la petite flèche à gauche du titre fait la même chose, et Affichage → Replier tous les titres / Déplier tous les titres agit sur la surface au premier plan. Pendant le défilement, les titres sortis par le haut restent épinglés dans un bandeau — cliquez sur l'un d'eux pour sauter à sa section. Replier est un état d'écran : le .md ne change pas et le texte replié reste dans le fichier.

Exporter : le PDF et le HTML sont générés à partir du même document que le mode lecture — le fichier obtenu est ce que vous venez de lire, avec le sommaire, la liste du dossier et les transclusions. Le HTML est autonome (les images locales y sont intégrées) et le PDF contient du texte vectoriel, donc restant consultable. Le HTML sort avec un balisage sémantique — titre avec ancre, encadré en <aside>, tableau avec en-tête, note de bas de page avec retour — et les formules en MathML : du vrai texte, qui se copie, se lit à voix haute et ne pixellise pas au zoom. Le thème suit chaque format : le HTML conserve les couleurs que vous voyez à l'écran, thème sombre compris (le fichier porte son propre fond) ; le PDF part toujours sur papier clair, car il est fait pour être imprimé et envoyé — si votre thème de contenu est sombre, il est imprimé avec le thème clair par défaut, et un thème clair que vous utilisez déjà est conservé. Word, OpenDocument, LaTeX, Typst et EPUB sont produits par LightNote lui-même, sans rien installer.

Le .docx et le .odt sortent avec titres, listes, tableaux, notes de bas de page, images et les formules en équations modifiables — équations Word dans l'un, objets LibreOffice Math dans l'autre ; le .tex contient un préambule complet et compile avec pdfLaTeX, XeLaTeX et LuaLaTeX. Si le dossier a une bibliographie et que la section Académique est activée, le .tex sort avec la citation vivante : [@clé] devient \autocite, le jeton [bibliography] devient \printbibliography, et un refs.bib avec les ouvrages cités est écrit à côté — l'application vous le dit. Compilez avec biber.

Le .typ est la même idée en Typst, qui compile en quelques secondes sans distribution LaTeX installée : les formules voyagent en LaTeX via le paquet mitex (téléchargé à la première compilation) et la citation sort en @clé avec #bibliography.

Le .epub est le livre numérique : un chapitre par titre de niveau 1, sommaire de navigation, images en fichiers du paquet et le même balisage sémantique que le HTML. Le .ipynb est le notebook Jupyter : le texte devient une cellule de texte et le bloc dans le langage du noyau devient une cellule de code — celui-là seulement, car une cellule de code est envoyée au noyau, et un diagramme Mermaid transformé en cellule s'exécuterait comme du Python la première fois qu'on le lancerait. Le noyau vient de la clé kernel dans les propriétés de la note, ou du bloc le plus fréquent.

La sortie n'est pas inventée : les cellules sortent sans résultat, parce qu'un résultat vient d'une exécution — la même règle que l'import de notebook suit déjà en écartant les sorties enregistrées. Et il y a Markdown pour… : la même note dans le dialecte de la destination — alerte > [!NOTE] sur GitHub, !!! note sur MkDocs, :::note sur Docusaurus, ::: {.note} sur Pandoc, l'écriture d'Obsidian ou CommonMark strict.

Le wikilien devient un lien relatif (hors Obsidian) et le commentaire %%…%% n'est pas publié, parce qu'il est privé. Avec Typst installé (winget install --id Typst.Typst), l'export propose Compiler le PDF sur place ; sans lui, le bouton devient Installer Typst..., qui ouvre le guide. Si le cours ou le client fournit un modèle Word, indiquez son .docx dans Configuration de l'espace de travail → Citations et références → Modèle Word : le fichier exporté sort avec les styles, le format de papier, les marges et l'en-tête du modèle. Une note peut en utiliser un autre en déclarant reference-docx: modele.docx dans ses propriétés. Les trois partent du Markdown de la lecture — citations déjà mises en forme, figures numérotées — et ce qui ne passe pas est signalé à la fin de l'export. La compilation s'exécute en arrière-plan, comme une tâche du panneau Activités : la fenêtre continue de répondre, et Arrêter l'interrompt.

Le diagramme Mermaid et la structure chimique entrent en image — dessinés sur papier clair dans le .docx, l'.odt et l'EPUB, aux couleurs de l'écran dans le HTML — ; seul lnote, qui n'a pas de fenêtre pour les dessiner, les sort en bloc de code. Et il y a Texte balisé pour… : reStructuredText, AsciiDoc, Org mode, MediaWiki et texte brut, écrits eux aussi par LightNote. Chacun reçoit sa construction native, et non une imitation : l'encadré devient .. note:: dans Sphinx, [NOTE] dans AsciiDoc et #+begin_note dans Org ; la formule devient .. math::, latexmath:[], du LaTeX pur et <math> ; la note de bas de page devient footnote:[] et <ref>. Le texte brut ne porte aucun balisage — le tableau sort aligné en colonnes, pour tenir dans un courriel ou un message de commit. Ce que la destination n'a pas est signalé à la fin : MediaWiki n'a pas d'encadré d'avertissement dans son cœur (il devient une citation avec l'étiquette en gras) et reStructuredText n'a pas de texte barré. Pour emporter un extrait sans écrire de fichier, le menu contextuel de l'éditeur propose Copier la sélection en (ou Copier la note en, sans sélection) : texte mis en forme à coller dans Word, Google Docs ou un e-mail, Markdown de GitHub, LaTeX et Typst. LaTeX et Typst ne portent que le corps — ni préambule ni titre —, car la destination est un document qui les a déjà ; le paquet dont l'extrait a besoin et la citation qui dépend de la bibliographie de la destination sont signalés dans la barre d'état, et le commentaire %%…%% reste lui aussi de côté.

Le RTF se trouve dans Autres formats (pandoc) et passe par pandoc, un programme séparé (winget install --id JohnMacFarlane.Pandoc) : sans lui, cette destination apparaît désactivée, avec la raison, et Installer pandoc... dans le même sous-menu ouvre le guide et fait l'installation. Si pandoc est déjà installé ailleurs, indiquez le fichier avec Je l'ai déjà : localiser sur le disque... dans le guide, ou dans Paramètres → Outils de code → Programmes externes.

Exporter avec options... est le premier élément du menu d'export — celui de l'onglet et celui de Fichier → Exporter la note sont le même menu. Il liste toutes les destinations, avec une recherche qui trouve le nom, l'usage et l'extension (wiki trouve MediaWiki, sphinx trouve reStructuredText), et n'affiche que les options valables pour la destination choisie : Table des matières au début, quand la note n'a pas encore de [TOC] ; Langue du document, qui décide la césure et les libellés que le document génère lui-même ; Citations vivantes ou résolues dans le texte, pour LaTeX et Typst ; le Modèle Word, avec la case qui en fait le modèle par défaut du dossier ; les Formules du HTML et de l'EPUB en MathML ou en image, pour les liseuses anciennes ou le HTML collé dans un e-mail ; le Papier du PDF, A4 ou Lettre ; et Compiler le PDF avec Typst juste après. Une option valable mais inutilisable reste désactivée avec la raison — citations vivantes sans bibliographie dans le dossier —, et une destination qui dépend d'un programme absent propose de l'installer sur place. Le dernier choix est mémorisé par dossier et la boîte de dialogue se rouvre comme vous l'avez laissée ; les éléments directs du menu continuent d'exporter avec les valeurs d'usine, pour qu'un choix fait des semaines plus tôt ne change pas le fichier d'un raccourci. Le [TOC] écrit dans la note vaut pour toutes les destinations : il devient la table des matières de Word et de LibreOffice (Word la met à jour à l'ouverture), \tableofcontents en LaTeX, #outline() en Typst et la liste de liens en HTML et en Markdown. Dans le texte mis en forme de Copier la sélection en, la formule et le diagramme partent en image, avec la source LaTeX en texte alternatif : on ne sait pas où le texte sera collé, et seule une image s'affiche pareil dans Word, Google Docs et un e-mail — pour l'équation modifiable, exportez le .docx ou l'.odt.

Le dossier entier sort aussi : Fichier → Exporter le dossier... (ou le clic droit sur un dossier de l'arbre) transforme ses notes en un site HTML — une page par note, avec un index quand aucune note n'est déjà devenue index.html —, en un ensemble de .docx ou .odt, ou en une arborescence de Markdown dans le dialecte de la destination. La structure de sous-dossiers est préservée, les liens et wikiliens entre les notes pointent désormais vers les fichiers sortis (dans Word et LibreOffice aussi, d'un document à l'autre) et les images et pièces jointes qui vivent dans le dossier partent avec, au même endroit. Ce qui est en dehors n'est pas copié : cela reste tel que vous l'avez écrit, et le rapport de fin liste chaque cas, avec les liens sans cible. Le dossier de destination doit être vide — ou vous cochez Remplacer les fichiers portant le même nom — et ne peut pas contenir le dossier exporté. Sans fenêtre : lnote folder-export --path . --format html --out site, et l'outil folder_export via MCP ; là, la transclusion, le [files] et la numérotation des figures ne sont pas résolus, car c'est la fenêtre qui les résout.

Édition formatée

Édition mise en forme (WYSIWYG) : le quatrième mode montre la note telle qu'elle rend — titre au corps d'un titre, liste avec sa puce, tableau en grille et image au fil du texte — au lieu du balisage. Le fichier reste le même .md : c'est LightNote qui l'écrit, pas Qt, et c'est pourquoi gras, italique, wikiliens, transclusion et encadrés survivent à l'aller-retour. Entrer dans le mode et en sortir sans éditer ne change pas un octet du fichier. La barre n'offre que ce que Markdown représente — titre, gras, italique, barré, code, listes (avec case de tâche), citation, lien, tableau et filet horizontal ; l'alignement, le retrait et la taille de police restent dehors car ils seraient perdus à l'enregistrement.

Dans un tableau, Tab passe de cellule et crée la ligne suivante sur la dernière. Entrée dans le vide à côté du tableau — là où le curseur tombe quand on clique à droite d'une ligne — ajoute une ligne à la fin, avec le curseur dans la première cellule. Dans une cellule, Entrée coupe la ligne sur place (elle va au fichier sous la forme <br>, la seule que le tableau Markdown accepte) et Ctrl+Entrée crée la ligne du dessous, curseur dans la même colonne. En survolant le tableau apparaissent des poignées discrètes : à gauche de la ligne, une paire de flèches qui la monte ou la descend — et qu'on peut aussi faire glisser pour la porter ailleurs ; au-dessus de la colonne, la paire qui la déplace latéralement ; et un + sur le bord du bas et un autre sur celui de droite, qui ajoutent une ligne et une colonne. La première ligne est l'en-tête et ne bouge pas. Tout cela est aussi dans le menu contextuel, sous Tableau — qui contient aussi Supprimer le tableau, la façon sûre de l'enlever en entier.

Dans un encadré (<details> ou :::), la dernière ligne ferme l'encadré et ne s'efface pas : c'est elle qui empêche le contenu du dessous d'y être avalé. Pour le défaire en gardant le texte, utilisez Supprimer l'encadré dans le menu contextuel. Entrée crée toujours une ligne. Dans un élément de liste vide, elle sort de la liste sans ajouter de ligne — comme dans Word — et dans un paragraphe vide, elle crée la ligne vide. Une ligne vide du fichier est la séparation normale entre paragraphes et n'apparaît pas comme ligne vide ; à partir de la deuxième, si, et elle revient dans le fichier telle que vous l'avez écrite.

Faire glisser le bord droit d'une image la redimensionne, et la largeur part dans le fichier sous la forme ![alt|300](photo.png). La barre compte douze commandes : gras, italique et titre directement, plus deux menus qui répartissent le reste selon ce qu’ils font — Formater agit sur ce qui est déjà écrit (marques, listes, citation, aligner le tableau et les opérations de Texte) et Insérer crée du nouveau (lien, image, tableau, bloc, diagramme, formule, encadré). Formater le tableau et le menu Texte restent propres à l’éditeur de texte : ici ils apparaissent désactivés, avec la raison. Atténuer le balisage est passé au bouton Affichage, à côté de la colonne de lecture et du défilement machine à écrire, qui valent dans les quatre modes. Et le menu Insérer propose ici la même chose que dans l’éditeur de texte — surlignage, exposant, indice, wikilien, note de bas de page, encadré (callout), bloc repliable, sommaire et liste de définitions —, tout ce que ce mode savait déjà montrer et ne savait pas créer.

Ce que le mode lecture affiche, l'édition mise en forme l'affiche aussi. L'émoji :fire: apparaît comme 🔥, ==surligné== comme une marque jaune, ^2^ et ~2~ comme exposant et indice, #étiquette comme une pastille et une adresse web nue comme un lien. Le fichier garde la forme écrite : ouvrir la note ne réécrit rien. Modifier à l'intérieur d'un fragment rendu conserve le balisage — taper au milieu d'un surlignage continue de surligner — et ce qui est tapé juste après reste dehors. Le commentaire %%…%% reste visible, atténué : le cacher le rendrait invisible et non modifiable.

Les callouts deviennent une boîte aussi en édition mise en forme. Une citation commençant par > [!NOTE] — ou [!TIP], [!IMPORTANT], [!WARNING], [!CAUTION] — s'affiche avec une barre et un titre colorés, comme en mode lecture : le marqueur cède la place au libellé du type, ou à votre propre titre si vous écrivez > [!TIP] Mon titre. Le fichier conserve le marqueur écrit, et modifier le titre préserve le type du callout. Les noms d'encadré d'Obsidian et de MkDocs sont compris eux aussi : [!SUCCESS], [!ABSTRACT], [!FAILURE], [!QUESTION] et leurs alias (tldr, missing, faq) tombent dans l'encadré le plus proche, si bien qu'une note venue de là s'affiche déjà en couleur — et, à l'exportation, chaque destination reçoit le nom qu'elle connaît.

C’est le mode par défaut d’une nouvelle installation. Si vous utilisiez déjà LightNote, votre mode précédent est conservé ; pour le changer, allez dans Paramètres → Général → Affichage initial du Markdown. Cliquer sur un titre dans le Plan effectue le saut dans le mode courant, sans vous sortir de l’édition mise en forme ni de la lecture.

Aligner la colonne d'un tableau. Le curseur dans le tableau, le menu contextuel propose Table → Aligner la colonne : À gauche, Centré, À droite ou Par défaut. L'alignement concerne la colonne entière — c'est ainsi que Markdown le représente — et part dans le fichier sur la ligne de séparation (:--, :-:, --:) ; Par défaut revient à ---. La coche du menu indique celui qui s'applique : à l'écran, une colonne --- et une :-- se ressemblent.

Le Plan montre ce qui est à l'écran. La liste des titres vient de la surface que vous regardez : en édition mise en forme, un titre à peine tapé apparaît aussitôt, sans attendre que le texte parvienne à l'éditeur de texte ; en mode lecture, elle inclut aussi les titres des notes transclues avec ![[note]], qui font partie de ce que vous lisez. Cliquer sur un élément mène au bon titre dans les deux cas. Et en mode divisé le défilement est désormais à double sens : faire défiler la lecture entraîne l'éditeur de texte, comme c'était déjà le cas dans l'autre sens.

Le balisage devient de la mise en forme à la frappe. Écrire **test** applique le gras et supprime les astérisques ; il en va de même pour *italique*, ~~barré~~, `code` et les formes avec tiret bas. En début de ligne, #  à ######  deviennent des titres, -  et 1.  des listes (le numéro tapé est le départ), - [ ]  une tâche à cocher, >  une citation, et --- seul devient un filet horizontal avec Entrée. Les marqueurs qui dessinent quelque chose agissent dès l'espace ; seul le titre attend la première lettre, parce qu'un titre vide ne montrerait rien.

Ctrl+Z n'annule que la conversion et rétablit le balisage littéral — la porte de sortie pour qui voulait vraiment les astérisques. Coller convertit aussi : un texte avec balisage collé arrive mis en forme, sans les marqueurs. La règle est ici plus prudente qu'à la frappe — seul un balisage sans ambiguïté déclenche — car en collant on ne voit pas le résultat se former : ainsi un extrait de code, plein de * et de _, reste du code. Rien n'est converti dans un bloc de code, car le balisage y est le sujet. Pour tout désactiver : Paramètres → Général → Convertir le balisage à la frappe.

De Word, de Google Docs ou d'une page, ce qui arrive est le texte avec sa structure : titre, liste (y compris celle de Word, qui en dessous n'est pas une liste), tableau, lien, code dans la ligne et bloc de code avec le langage. La police, la taille et la couleur de l'origine restent dehors : le Markdown ne les représente pas, et les garder laisserait un passage en Arial bleu qui disparaît à l'enregistrement. L'image qui vient avec devient une pièce jointe de la note quand Word ou le navigateur l'a laissée dans le dossier temporaire, qui se vide tout seul ; celle qui pointe vers Internet continue d'y pointer, et son menu contextuel propose Télécharger l’image dans l’espace de travail.

Images, liens et wikiliens

Image et lien. Trois chemins pour insérer une image : Insérer → Image… dans la barre, taper ![](photo.png), ou faire glisser le fichier dans la note — une image insère l'image, une note .md insère un [[wikilien]], et tout autre fichier devient un lien cliquable dont le libellé est le nom du fichier — et si vous en déposez plusieurs d'un coup, chacun va sur sa propre ligne. Le chemin enregistré est relatif au dossier de la note dès que possible, pour que la note continue de fonctionner après un déplacement du vault. L'adresse d'un lien n'apparaît pas dans le texte (on voit le libellé) : elle s'affiche donc dans la barre d'état au survol, et Ctrl+clic l'ouvre — une adresse web dans le navigateur, un chemin local dans LightNote.

Modifier un lien existant : placez-y le curseur et utilisez le bouton Lien (ou Modifier le lien… dans le menu contextuel) — la fenêtre s'ouvre avec le texte et l'adresse remplis. Le menu contextuel sur un lien propose aussi Copier l'adresse du lien et Supprimer le lien, qui défait le lien en gardant le texte. Sur un [[wikilien]] il propose Ouvrir la note et Copier la cible ; sur une #étiquette, Rechercher l'étiquette et Copier l'étiquette. Sur une image il y a Texte alternatif… — invisible en mode formaté, mais il part dans le fichier et dans la recherche — et, une fois la poignée tirée, Taille d'origine, qui rend à l'image sa propre taille. Sur une image ayant une adresse web apparaît Télécharger l'image dans l'espace de travail : le fichier va dans Pièces jointes/ à côté de la note, et la note pointe dessus — sinon elle dépendrait de la survie de cette URL. Et il y a le chemin le plus court de tous : sélectionnez un texte et collez une adresse — elle devient [texte](adresse) au lieu de remplacer la sélection. Cela vaut dans les deux surfaces d'édition. Tant qu'elle n'est pas téléchargée, l'image du web apparaît comme une carte avec l'adresse et le chemin du menu — LightNote ne va pas sur le réseau pour rendre une note, et l'endroit portait auparavant le cadre vide d'image cassée, sans rien dire de ce qu'il faut faire.

Et le balisage peut être défait. Dans le menu Format, les entrées Surlignage, Exposant et Indice apparaissent cochées quand le curseur se trouve à l'intérieur de l'une d'elles, et cliquer là retire le balisage au lieu de l'appliquer à nouveau. Au clavier, il y a le chemin rapide : avec le curseur à la fin d'un fragment mis en forme, Ctrl+Shift+Retour arrière rend le balisage littéral moins un caractère — gras devient **gras* en texte ordinaire — et compléter le délimiteur manquant le reforme. Cela vaut pour gras, italique, barré, code, surlignage, exposant et indice. La touche Retour arrière seule efface une lettre, là comme partout ailleurs.

Modifier le diagramme sans quitter la note. Un diagramme Mermaid ou une formule $$…$$ apparaissent dessinés dans l'éditeur mis en forme ; pour atteindre la source, placez le curseur dessus et appuyez sur Ctrl+Entrée — ou passez par Modifier ce bloc… dans le menu contextuel. La barre du bas montre le texte, la note reste verrouillée tant qu'elle est ouverte, et la fermer (✕, Esc, Ctrl+Entrée, un clic dans la note) applique : le chemin de retour est Ctrl+Z. Dans le même menu, Extraire vers une nouvelle note… écrit le passage sélectionné dans une note à côté de celle-ci et laisse un [[wikilink]] à sa place — le balisage suit, donc titre, liste et tableau arrivent entiers dans la nouvelle note. Le champ ne montre que le contenu : les lignes ```mermaid et ``` (ou les $$) sont devenues le sélecteur de type dans l’en-tête de la barre, qui bascule aussi entre diagramme, formule et bloc de code. La touche Entrée conserve l’indentation de la ligne, ce qui dans un langage indenté comme Mermaid est le geste de chaque ligne. Et le menu contextuel du bloc propose Copier le code Markdown et Copier l’image — le code se colle dans n’importe quel éditeur Markdown et se redessine ; l’image se colle dans un courriel ou un chat. Les deux valent aussi en lecture seule.

Demander la modification à l'IA. La barre du bloc ouverte, le bouton IA de l'en-tête ouvre une ligne où vous écrivez ce qu'il faut changer — « ajoute un chemin d'erreur qui revient au début », « remplace la somme par une intégrale » — et Entrée l'envoie. À côté du champ, un bouton indique quelle IA va répondre : son menu change d'assistant pour ce bloc seulement, sans toucher à votre IA par défaut, et contient Voir ce qui sera envoyé. Cela vaut le coup d'œil, car l'IA reçoit le bloc, le titre et la section de la note et le texte alentour — c'est ce qui permet de demander que le diagramme reflète ce qui est écrit là. La réponse arrive dans le champ et le dessin est refait aussitôt : Ctrl+Z ramène ce que vous aviez écrit. LightNote vérifie la réponse avec son propre moteur de rendu et, quand elle ne dessine pas, demande une correction en indiquant au modèle la ligne et la commande refusées — si cela échoue aussi, il écrit la réponse quand même et laisse la raison dans la barre, pour que vous corrigiez les deux lignes à la main. Le bouton n'apparaît que sur un diagramme, une formule et une structure chimique.

Pointer vers une section, et étiqueter depuis les propriétés. [[Note#Section]] ouvre la note à cette section — l'ancre nomme le texte du titre — et ![[Note#Section]] n'inclut qu'elle (jusqu'au titre suivant de même niveau ou supérieur, sous-titres compris). Une ancre qui ne correspond à aucun titre le dit dans la barre d'état, et l'inclusion reste telle quelle : y amener la note entière reviendrait à livrer autre chose en silence. Et les tags: du frontmatter comptent désormais comme étiquettes de la note, dans les deux écritures (tags: [a, b] et la liste sur ses propres lignes) — elles arrivent aux Bases, à la recherche par étiquette et à ce que voit l'assistant, avec les #étiquettes du corps. Sans nom de note, l'ancre pointe vers la note elle-même : [[#Conclusion]] saute à cette section sans ouvrir d'onglet, et ![[#Conclusion]] amène la section là où vous êtes. Et les ancres s'imbriquent : [[Thèse#Méthode#Échantillon]] est l'Échantillon situé dans Méthode, et non le premier de ce nom dans la note. La troisième forme pointe vers un bloc : une ligne qui se termine par ^id (ou un ^id seul juste sous le bloc) est la cible de [[Note#^id]]. LightNote ne crée pas ces identifiants — il vous emmène vers ce que vous avez écrit. Et l'ancre d'une cible qui n'est pas une note est l'adresse à l'intérieur de celle-ci : [[article.pdf#page=3]] ouvre le PDF à cette page.

Wikilinks : tapez [[ pour autocompléter avec les notes de l'espace de travail ; le lien se ferme tout seul avec ]]. Maintenez Ctrl et cliquez sur un [[note]] pour ouvrir la note correspondante. Le panneau Connexions montre les liens entre les notes. La figure intégrée d'Obsidian s'affiche aussi : ![[photo.png]] est dessinée comme une image, et ![[photo.png|300]] respecte la largeur. Le fichier garde ce que vous avez écrit — le chemin de l'image n'est jamais écrit à la place du jeton.

Et la pièce jointe qui n’est pas une image devient une carte : ![[article.pdf#page=3]], ![[cours.ogg]] et ![[carte.canvas]] apparaissent comme un cadre portant le nom du fichier, cliquable — et le PDF s’ouvre à la page que vous avez indiquée. Les .canvas et .base d’Obsidian ont une ligne de plus, qui dit que le fichier reste dans le dossier et que LightNote ne le dessine pas. Une cible qui n’existe pas reste telle que vous l’avez écrite : une carte y promettrait un fichier disparu. Au milieu d’une phrase, l’image s’affiche de la même façon et la pièce jointe devient seulement le nom du fichier, que Ctrl+clic ouvre : une carte à cet endroit couperait le paragraphe. La même note sous un autre nom : écrivez aliases: [Échantillonnage, Méthode d’échantillon] dans les propriétés de la note et [[Échantillonnage]] l’ouvre — l’alias entre aussi dans l’autocomplétion de [[. Un fichier portant ce nom l’emporte toujours sur un alias. Les alias viennent de l’index du dossier, que l’application reconstruit en arrière-plan à l’ouverture de l’espace de travail : un aliases: fraîchement écrit se résout au balayage suivant, et non dans la même seconde.

Panneau Étiquettes

Le panneau Étiquettes. La bande de la barre latérale a une section Étiquettes : l'arbre de toutes les #étiquettes de vos notes, imbriquées par / (#projet/alpha et #projet/beta deviennent des branches de projet), avec le nombre de notes à côté — comptées par note, pas par occurrence. Sélectionner une étiquette liste en dessous les notes qui la portent (un parent montre aussi celles de ses branches) ; un double-clic ouvre la note. Le panneau lit l'index : il voit donc les deux sources, les #étiquettes du corps et les tags: du frontmatter. Ctrl+clic sur une étiquette dans une note ouvre ce panneau avec elle sélectionnée — avant, cela ouvrait la recherche textuelle de #étiquette, qui ne trouve pas la note qui la déclare dans le frontmatter. Pour l'occurrence littérale dans le texte, utilisez la recherche globale.

Encadrés, notes de bas de page et balisage enrichi

Lecture enrichie : les blocs de code entre clôtures apparaissent dans un cadre avec l'étiquette du langage et un lien copier ; ~~barré~~ et ==surligné== sont rendus ; et les callouts de style GitHub (> [!NOTE], [!TIP], [!WARNING], [!IMPORTANT], [!CAUTION]) deviennent des cadres colorés. Les étiquettes #hashtag sont mises en évidence et, avec Ctrl+clic, ouvrent la recherche de cette étiquette ; le bloc de frontmatter YAML en haut (---) est mis en évidence. Dans la barre d'outils de l'onglet, un bouton permet d'exporter la note en PDF/HTML, une colonne de lecture centrée basculable et les modes d'affichage de la note. Le mode Zen (F11) et le défilement machine à écrire aident à écrire sans distractions.

Les notes de bas de page sautent dans les deux sens. La référence [^1] apparaît comme un chiffre en exposant, et Ctrl+clic dessus mène à la définition ; dans la définition, le marqueur [^1]: reste visible — c'est la cible du saut, et vous devez le voir pour savoir quelle note vous modifiez — et Ctrl+clic dessus revient à la référence. Contrairement à beaucoup de visionneuses Markdown, l'éditeur ne renumérote pas les notes et ne déplace pas les définitions à la fin : l'ordre du fichier est le vôtre. L'écriture en ligne d'Obsidian et de Pandoc — ^[le texte de la note] — est dessinée aussi : vous écrivez le texte à l'endroit où la note est appelée, et en mode lecture il apparaît numéroté à la fin. Le fichier garde ce que vous avez écrit, et à l'export elle devient une vraie note de bas de page dans Word, LaTeX, Typst et EPUB.

L'admonition MkDocs (!!! note avec le corps indenté de 4 espaces) est conservée telle qu'elle est écrite en édition mise en forme : l'indentation est ce qui fait appartenir le corps à l'admonition, donc son texte ne reçoit pas de mise en forme riche — en échange, ouvrir la note et l'enregistrer ne défait pas la construction.

Les boîtes avec marqueur de fermeture s'affichent aussi comme une boîte. :::tip … ::: (Docusaurus) et <details> … </details> reçoivent une barre et un titre colorés, dans les deux écritures : la compacte et celle avec des lignes vides. Le marqueur d'ouverture cède la place au libellé du type, au titre que vous avez écrit ou au texte du <summary> ; celui de fermeture quitte l'écran et reste dans le fichier, car le balisage que l'application écrit elle-même ne doit pas rester littéral sur la page. Ce qui demeure est la dernière ligne de l'encadré : c'est elle qui le délimite, c'est là qu'on met le curseur pour continuer à écrire dedans, et elle ne s'efface pas — sans elle, le contenu du dessous y serait avalé. Pour le défaire en gardant le texte, utilisez Supprimer l'encadré dans le menu contextuel. Le : de la liste de définition reste atténué. Le <summary> doit être sur la même ligne que le <details> pour devenir le titre : sur une ligne à lui, il s'affiche tel quel et la boîte garde le libellé par défaut.

HTML en ligne et bloc de code. <kbd>, <mark>, <sub> et <sup> sont également rendus en édition mise en forme : les balises disparaissent et il ne reste que le contenu, comme en mode lecture. Le bloc de code clôturé reçoit une boîte, avec le nom du langage et un lien copier dans le coin — le même lien en édition mise en forme et en mode lecture, là où l'on copie le plus de code. Il ne prend que le corps du bloc (sans les marqueurs) et affiche copié un instant ; les deux étiquettes n'apparaissent que lorsqu'elles tiennent sans écrire par-dessus le code.

Plus dans la lecture : le bloc de frontmatter YAML en tête n’apparaît pas dans la note rendue — il se modifie dans le panneau Propriétés. Les tags #hashtag deviennent des pastilles cliquables qui ouvrent la recherche de ce tag (comme Ctrl+clic dans l’éditeur). Les commentaires façon Obsidian (%%ceci reste caché%%, ou un bloc entre des lignes contenant %%) restent uniquement dans le fichier. Outre les callouts de GitHub, les encadrés des dialectes Docusaurus (:::tip Titre … :::) et MkDocs (!!! note "Titre" avec le corps indenté, et ??? note) sont également rendus — pratique pour lire des dépôts de documentation.

Nouveautés de la lecture : en plus de ~~barré~~ et ==surligné==, vous avez l'exposant ^x^, l'indice ~x~, les emoji abrégés (:rocket:), l'auto-lien des URL, les notes de bas de page [^1], les blocs repliables <details>, les listes de définitions, les tâches - [ ]/- [x] (⬜/✅) et le marqueur [TOC] (sommaire cliquable dans la lecture) ; ainsi que les images locales et le HTML en ligne (<kbd>, <mark>…). Le panneau Plan (barre de l'onglet) parcourt les titres en suivant le curseur, et le bouton Insérer (ou le menu contextuel → Format/Insérer) applique n'importe quelle mise en forme.

Titres, dossier et texte

En-têtes épinglés (sticky scroll) : lors du défilement, les en-têtes qui contiennent la ligne du haut restent épinglés dans un bandeau en haut de l'éditeur ; cliquer sur l'un d'eux saute à la section (à activer dans Paramètres → Markdown). Le menu contextuel d'un dossier dans l'arborescence crée/ouvre la Note du dossier (index.md avec frontmatter), utile comme index.

Note de dossier et liste de fichiers : un double-clic sur un dossier ouvre son index.md, s'il existe. Dans n'importe quelle note, le jeton [files] (ou [arquivos]) seul sur une ligne est remplacé dans l'édition mise en forme et dans la lecture par la liste des fichiers du dossier de la note, sous forme de liens cliquables — générée à la volée, sans rien écrire dans le fichier (comme [TOC]).

Opérations de texte et de ligne. Les opérations de l'éditeur de code s'appliquent aussi à la note — via le sous-menu Texte du bouton Formater de la barre de l'onglet, le menu contextuel et les sous-menus Lignes et Nettoyage du menu Édition : déplacer la ligne (ou les lignes sélectionnées) vers le haut/bas (Ctrl+Shift+↑/↓), dupliquer (Ctrl+Shift+D), supprimer (Ctrl+Shift+L), trier (A→Z / Z→A), inverser l'ordre, joindre les lignes, supprimer les lignes en double ou vides, supprimer les espaces et casse (MAJUSCULES/minuscules/inverser). Numéroter les lignes… ouvre une boîte de dialogue avec début, pas, zéros initiaux et séparateur — avec la valeur par défaut (". "), le résultat est une liste numérotée Markdown valide. Avec une sélection, l'opération ne s'applique qu'à elle (étendue aux lignes entières) ; sans sélection, à tout le document — toujours une seule étape d'annulation. La barre de l'onglet propose aussi le bouton IA : Demander / Modifier avec l'IA — les mêmes Ctrl+K / Ctrl+I que dans le code — et Interroger les notes, le chat qui répond à partir des notes de l'espace de travail.

Suggérer un titre et des étiquettes. Dans le même bouton IA de la note, Suggérer un titre et des étiquettes… demande à l'assistant par défaut un titre et des étiquettes pour la note ouverte. Il lit la note (pour une note longue, le début et la fin) et la liste des étiquettes que vous utilisez déjà dans l'espace de travail, et préfère les réutiliser plutôt que d'inventer des synonymes. La suggestion apparaît dans une petite fenêtre modifiable : changez le titre, décochez ou corrigez les étiquettes. Appliquer écrit title: et tags: dans les propriétés de la note — les étiquettes s'ajoutent à celles qu'elle a déjà, sans jamais les remplacer — et, si la note n'a ni titre ni en-tête # …, propose de placer aussi le titre en haut. C'est une seule modification : Ctrl+Z l'annule. Sans aucune IA configurée, l'élément propose d'en connecter une. Le texte de la note quitte la machine si l'assistant est un service dans le cloud ; avec un modèle local, non.

Titres repliables : cliquez sur la petite flèche à gauche d'un titre (ou utilisez Ctrl+Shift+[ / Ctrl+Shift+]) pour replier et déplier la section ; dans Affichage se trouvent Replier/Déplier tous les titres. Le pliage est purement visuel — il n'est jamais écrit dans le fichier — et LightNote s'en souvient d'une session à l'autre. Sauter depuis le Sommaire ou depuis une recherche dans une section repliée la déplie.

Classeur : le dossier comme une œuvre

Ce que c’est : un dossier dont les notes sont des chapitres, dans un ordre que vous déclarez. Cela vaut pour un livre, un mémoire, un cours, un manuel, un runbook ou un journal de bord — le mécanisme est le même. Dans le menu contextuel du dossier, Transformer en classeur ouvre un écran avec les notes dans l’ordre actuel : faites glisser pour réorganiser puis confirmez. L’ordre est enregistré dans la clé chapters: du index.md du dossier — un fichier texte à vous, qui voyage avec les notes et reste valable sur n’importe quelle machine. Un sous-dossier peut aussi être nommé dans l’ordre : ses chapitres entrent à la position où il apparaît, et il déclare son propre ordre dans son index.md — c’est ainsi qu’un livre gagne des parties. La couverture d’un sous-dossier ne devient pas une page du document ; elle sert à déclarer l’ordre de ce niveau et à naviguer.

Naviguer : avec un ordre déclaré, la barre de la note affiche Chapitre 3 sur 12, avec une flèche de chaque côté (Alt+PgUp et Alt+PgDn) ; le bouton du milieu liste tous les chapitres. Le panneau Sommaire affiche alors deux niveaux : les chapitres de l’œuvre et, sous celui qui est ouvert, ses titres. Aux extrémités de l’œuvre la flèche est grisée. Dans un dossier sans ordre déclaré, rien de tout cela n’apparaît et tout reste comme avant.

Le modèle des notes : un classeur peut déclarer de quel modèle partent les notes créées à l’intérieur (la clé template:). Il y a cinq modèles prêts — chapitre de livre, chapitre de mémoire, cours, étape de procédure et entrée de journal — et en choisir un l’enregistre comme fichier dans le dossier Templates, où il reste modifiable. Une note créée dans le classeur entre seule dans l’ordre ; un fichier déposé là depuis l’extérieur reste sous Hors de l’ordre jusqu’à ce que vous l’adoptiez. Renommer un chapitre corrige la clé et conserve sa position. Pour partir d’une œuvre toute faite, Structurer à partir d’un modèle… (dans le menu contextuel du dossier) écrit les deux clés d’un coup — l’ordre et le modèle des chapitres — en conservant la couverture que vous avez déjà écrite ; et tant qu’un chapitre déclaré n’existe pas encore, le Sommaire affiche un bouton qui les crée tous d’un coup, chacun déjà à partir du modèle du dossier. Rien n’est écrasé : un chapitre déjà présent reste tel quel.

Réunir en un seul document : à l’exportation du dossier, la case Réunir les chapitres en un seul document produit un fichier avec les chapitres dans l’ordre déclaré. Comme le texte est réuni avant d’être rendu, les notes de bas de page, les figures, les tableaux et les citations sont ensuite numérotés sur tout le document — et un renvoi d’un chapitre vers une figure d’un autre se met à fonctionner. Ce qui n’est pas dans l’ordre déclaré reste dehors, et le rapport dit quoi.

Propriétés, thème et zoom

Propriétés de la note : le panneau latéral Propriétés affiche le frontmatter YAML sous forme de champs typés (texte, nombre, date, case à cocher), avec la case Type en haut. Définir le type et les propriétés est ce qui permet de réunir les notes dans une Base.

Thème de la note : la case Thème du panneau Propriétés définit l'apparence de cette note — les couleurs et la police du texte — sans toucher au thème du reste de l'application. Le choix va dans le frontmatter (la clé theme), il voyage donc avec le fichier : la note s'affiche à l'identique sur n'importe quelle machine. Le bouton voisin écrit les couleurs dans la note elle-même, pour qu'elle soit identique même chez quelqu'un qui n'a pas ce thème. Sans la clé, la note suit le thème de l'espace de travail. Si vous préférez que les notes venues d'ailleurs ne changent pas votre apparence, désactivez Respecter le thème déclaré dans la note dans Paramètres → Markdown.

Un thème que LightNote ne connaît pas encore : la liste des thèmes est un unique fichier téléchargé depuis le site ; une note citant un thème publié après votre dernière mise à jour ne le trouve donc tout simplement pas. La note s'ouvre alors avec le thème de l'espace de travail et le panneau Propriétés le signale, avec un raccourci vers les thèmes disponibles. LightNote cherche la liste à jour de lui-même — une fois par session, en arrière-plan et sans bloquer la note. Si vous préférez qu'il ne télécharge jamais rien, désactivez Récupérer le catalogue d'outils en ligne dans Paramètres → Fonctions.

Ctrl++ et Ctrl+− (ou Ctrl+molette) changent la taille de la note, et Ctrl+0 revient à 100% — pratique pour lire une note longue sans toucher à la police de toutes. L'éditeur et la lecture sont mis à l'échelle ensemble : en mode divisé, les deux côtés restent de la même taille. Un <svg> écrit directement dans la note est aussi dessiné dans la lecture : vous pouvez coller un graphique généré par l'IA sans en faire un fichier à part.

Combien de mots, et où. La barre d'état compte les mots de la note et estime le temps de lecture ; à côté, section N est le compte de la section où se trouve le curseur — la même que le Sommaire met en évidence, de son titre jusqu'au suivant de niveau égal ou supérieur. En déclarant un objectif quotidien dans Paramètres → Notes et écriture, aujourd'hui N/M apparaît aussi : ce qui a augmenté dans les notes ouvertes aujourd'hui. Supprimer ne retire rien — réviser son propre texte ne peut pas devenir une punition —, une note non ouverte ne compte pas, et à minuit le compteur repart à zéro.