L’espace Markdown

L’espace Markdown sert aux fichiers texte d’un projet : README, plans, spécifications, décisions, prompts, journaux, AGENTS.md. Ce que vous enregistrez reste du Markdown, lisible par Git, par vos scripts et par les outils de quelqu’un d’autre.

Deux façons d’éditer le même fichier

Un sélecteur bascule entre Visuel et Source. Vous pouvez aussi choisir Affichage > Basculer entre Source et Visuel (⇧⌘E).

Visuel montre la hiérarchie, les styles, les tableaux, les images, les cases à cocher, les équations et les diagrammes. Source montre le Markdown littéral, présenté comme du code.

Les deux modifient le même document. Vous pouvez passer de l’un à l’autre au milieu d’une phrase.

Le mode Visuel n’est pas un aperçu : ce que vous y modifiez est reconverti en Markdown. Balise n’enregistre jamais du HTML à la place de votre fichier source.

Choisir la typographie du mode Visuel

Réglages > Markdown propose trois présentations globales : Thème Mac par défaut, New York pour une lecture éditoriale aérée, et GitHub pour un rythme plus compact.

Le changement est immédiat dans les fenêtres ouvertes et conserve le curseur, la sélection, le défilement et l’historique d’annulation. Seuls la typographie, la largeur de lecture et les espacements changent ; les couleurs restent celles de macOS et suivent automatiquement le mode clair ou sombre.

La présentation n’appartient pas au document. Le Markdown littéral, le mode Source, l’impression, l’export et la copie enrichie restent identiques.

Exporter un document

Fichier > Exporter… prépare une copie du contenu courant, y compris les modifications non enregistrées. Le contenu est capturé à l’ouverture du panneau ; l’export n’enregistre pas le fichier Markdown.

Choisissez HTML autonome, HTML sans thème, PDF ou Document Word (DOCX). Les styles de publication Standard, Éditorial et Compact sont indépendants du thème de l’éditeur. Le PDF propose le format A4 ou Lettre, l’orientation, les marges, un en-tête, un pied de page et les numéros de page. Les titres deviennent des signets et les liens internes permettent de naviguer dans le PDF.

Le HTML autonome contient les images locales accessibles et les ressources de rendu nécessaires. Les diagrammes sont figés en SVG. Le HTML sans thème conserve les formules en MathML, sans feuille de thème Balise. Les sections repliables sont développées dans les sorties.

Une image locale manquante, inaccessible ou trop volumineuse empêche l’export ; le message indique la ressource concernée. Les images distantes restent des références en ligne dans le HTML et ne sont pas téléchargées pour le PDF. Le panneau annonce cette limite lorsqu’il en rencontre. Un rendu technique incomplet doit être corrigé avant de publier.

Pour exporter une nouvelle version du document, ouvrez Fichier > Exporter… et choisissez le format et la destination. L’export utilise le contenu courant.

Le DOCX conserve des titres, paragraphes, listes, tableaux et notes modifiables. Les formules et diagrammes deviennent des images issues du rendu annoncé dans le panneau. Ils conservent leur apparence et leurs numéros, mais ne deviennent pas des objets LaTeX ou Mermaid éditables dans Word. Les images distantes sont représentées par leur texte alternatif et leur lien. Le DOCX utilise une présentation Word sobre indépendante des styles HTML/PDF.

Envoyer dans Slack

La destination Slack est disponible dans Fichier > Exporter…. Connectez votre espace pour envoyer une copie du document dans un canal.

1. Ouvrez Fichier > Exporter… et choisissez Slack.
2. Cliquez sur Connecter Slack, puis autorisez Balise dans l’espace Slack voulu depuis le navigateur.
3. Choisissez un Canal public ou privé dont vous êtes membre.
4. Cliquez sur Envoyer dans Slack pour publier sous votre identité Slack.

Le message contient une copie du contenu capturé à l’ouverture du panneau, y compris les modifications non enregistrées. L’envoi ne modifie ni n’enregistre votre fichier Markdown. Après confirmation, Ouvrir le message dans Slack permet de consulter le résultat. Slack applique sa propre présentation au Markdown ; les diagrammes Mermaid et les formules de Balise n’y conservent pas leur rendu.

Remplacez les liens et images qui pointent vers des fichiers de votre Mac par des adresses Web accessibles aux destinataires. Si Balise signale un contenu trop long, préparez un extrait plus court ; le texte n’est pas tronqué automatiquement. Si le résultat de l’envoi est incertain, vérifiez le canal dans Slack avant de réessayer pour éviter un doublon.

Déconnecter sur ce Mac retire la connexion enregistrée sur ce Mac. Pour publier depuis un autre compte, reconnectez-vous puis choisissez de nouveau le canal.

Écrire un document long

Présentation → Concentration atténue les paragraphes voisins tout en gardant le passage actif lisible. Présentation → Machine à écrire recentre le curseur pendant la saisie. Les deux modes sont indépendants, disponibles en Source et en Visuel, et conservés pour les fenêtres Markdown. Faire défiler manuellement suspend le recentrage jusqu’à la prochaine saisie. Ces modes ne modifient ni le fichier ni son export.

Le compteur au bas du document affiche les mots du document ou de la sélection. Un clic ouvre les caractères, les caractères hors espaces, les lignes source et une estimation de lecture à 200 mots par minute. Le compteur porte sur la prose : titres, listes, cellules, légendes et notes comptées une fois. Il exclut le code, les métadonnées et les destinations de liens. Les caractères sont des graphèmes Unicode ; apostrophes et traits d’union internes réunissent un mot. L’estimation est moins précise pour les langues qui ne séparent pas leurs mots par des espaces. Les limites d’un document volumineux sont affichées.

Mettre en forme

Le menu Format et l’inspecteur appliquent les constructions habituelles : paragraphes et titres de niveaux 1 à 6, gras, italique, barré, code en ligne, liens, listes à puces, listes numérotées, tâches à cocher, citations, blocs de code, tableaux, images.

Le niveau d’une liste s’augmente et se réduit. Les tâches vides et les sous-listes restent présentes après sauvegarde et réouverture. Les cases à cocher collées peuvent être cochées directement en Visuel. Quand le curseur est dans un tableau, l’inspecteur affiche son nombre de lignes et de colonnes et permet d’en ajouter ou d’en retirer sans reconstruire le reste du document.

Les raccourcis sont dans Raccourcis clavier.

Surligner, souligner, mettre en exposant ou en indice

Format → Surligner, Souligner, Exposant et Indice agissent sur la sélection en Visuel comme en Source. Ces commandes se trouvent aussi dans Autres styles de texte, sous les actions Texte de l’inspecteur. Elles n’ajoutent pas de raccourci clavier.

Un second clic retire le style de la sélection. Exposant et indice se remplacent mutuellement sur la portion choisie. Sans sélection, la commande insère text, sélectionné pour être remplacé par votre saisie. La saisie suivante conserve son historique habituel ; l’insertion du style reste une étape d’annulation distincte.

Le fichier conserve les balises <mark>, <u>, <sup> et <sub>. Les attributs HTML et CSS importés ne font pas partie de ces styles. Les commandes sont indisponibles dans le code, les équations et les documents en lecture seule.

Insérer un lien, un tableau ou un bloc de code

Le menu Insérer donne aussi accès à Ajouter un lien…, Tableau et Bloc de code, en Visuel comme en Source. Ces accès utilisent les mêmes commandes que Format et l’inspecteur. Le lien reprend la sélection courante ; Bloc de code conserve son comportement de bascule.

Le menu regroupe le lien et les notes de bas de page, puis les tableaux, blocs de code et lignes horizontales, puis les images, équations et diagrammes Mermaid. Ces commandes sont désactivées hors d’un document Markdown modifiable.

⌘K reste le raccourci du lien dans Format. Les nouveaux accès dans Insérer n’ajoutent pas de raccourci.

Insérer un sommaire

Insérer → Sommaire… crée une liste Markdown de liens vers les titres. Choisissez les niveaux H1 à H6 et, si nécessaire, excluez le premier H1. L’aperçu montre la liste avant application. Sans titre admissible, le bouton Appliquer reste désactivé.

Sans sélection, la liste est insérée au caret. Avec une sélection, le panneau montre le texte qui sera remplacé. Pour actualiser un sommaire, sélectionnez explicitement sa liste puis utilisez de nouveau Insérer → Sommaire…. Balise ne reconnaît ni ne réécrit automatiquement une liste existante.

Les liens différencient les titres répétés. Les titres dans le code, les métadonnées et les citations ne sont pas proposés. Les titres Setext sont inclus. Les ancres générées utilisent le texte du titre en minuscules, sans accents, avec un suffixe pour les doublons ; les titres sans caractère admissible utilisent section. Après un renommage de titre, actualisez explicitement le sommaire. Les lecteurs Markdown externes peuvent appliquer une autre convention d’ancre.

Le sommaire demeure une liste éditable dans le fichier, sans index local requis. Une application s’annule en une étape.

Pour retrouver le sommaire sans sélectionner sa liste, cochez **Créer un sommaire géré** lors de l’insertion. Deux commentaires dans le fichier délimitent alors sa zone. Insérer → Mettre à jour le sommaire… présente la liste antérieure, les entrées ajoutées, retirées ou modifiées, et le résultat proposé. Choisissez les niveaux, vérifiez les deux versions, puis appliquez.

Balise ne met jamais le sommaire à jour à l’ouverture ou à la sauvegarde. Une seule zone complète est admise : des marqueurs absents, multiples ou mal fermés bloquent la mise à jour. Le texte reste accessible en Source. Une liste manuelle n’est jamais assimilée automatiquement à une zone gérée. Les listes ordinaires peuvent toujours être remplacées après sélection explicite.

Sections repliables

Insérer → Section repliable… demande un titre simple et un contenu Markdown. Sans sélection, la section est créée au curseur ; avec une sélection, le panneau reprend son texte comme contenu. Le fichier conserve les balises HTML details et summary.

La flèche ouvre et ferme la section sans modifier le fichier. Pour éditer, ouvrez la section puis choisissez Modifier la section…. L’option Ouverte par défaut change l’attribut open enregistré. Le titre, le contenu et cette option sont appliqués ensemble en une action annulable. Retirer le repli conserve le titre en paragraphe et le contenu ; Supprimer la section retire le bloc entier.

Les listes et blocs de code ordinaires s’affichent dans le corps. Leur édition passe par le panneau. Les diagrammes et équations internes n’ont pas de rendu spécialisé. Les sections imbriquées, mal fermées ou avec un titre HTML complexe restent du texte protégé à modifier en Source. Les attributs inconnus sont conservés dans le fichier sans être exécutés dans le rendu.

La recherche ouvre temporairement la section contenant un résultat. L’impression et l’export HTML développent les sections pour inclure leur contenu. Coup d’œil les présente également développées, sans flèche interactive ; utilisez Balise pour les replier.

Encadrés

Insérer > Encadré propose Note, Astuce, Important, Avertissement et Prudence. Les marqueurs du fichier restent NOTE, TIP, IMPORTANT, WARNING et CAUTION, dans une citation Markdown. Un lecteur qui ne reconnaît pas cette convention peut afficher une citation ordinaire avec le marqueur.

Dans le mode Visuel, le titre automatique de chaque encadré suit la langue choisie dans Balise, même si macOS utilise une autre langue. Par exemple, le marqueur TIP affiche « Astuce » en français, « Tip » en anglais et « Consejo » en espagnol. Changer cette langue ne traduit pas votre texte et ne modifie pas les marqueurs du fichier.

Avec une sélection, les paragraphes concernés sont enveloppés dans l’encadré. Sans sélection, l’encadré est créé au curseur ; en Visuel, son panneau de contenu s’ouvre pour saisir le texte. La création et l’application du contenu sont deux actions distinctes dans l’historique.

Dans l’inspecteur Document > Encadrés, Type d’encadré change seulement le marqueur. Modifier l’encadré… édite son contenu Markdown, notamment les paragraphes, listes, liens et blocs de code. Convertir en citation retire le marqueur en gardant le corps cité. Une citation ordinaire peut recevoir un type depuis ce même inspecteur. Le panneau de contenu propose aussi Convertir en texte ordinaire. Ces actions s’annulent individuellement.

Le bloc est protégé lors d’une édition visuelle voisine. Les marqueurs inconnus, les titres personnalisés et les encadrés imbriqués importés ne sont pas normalisés ; leur modification se fait en Source. Une icône et un libellé accompagnent la couleur du type.

Notes de bas de page

Insérer > Note de bas de page… propose un identifiant libre et un éditeur de contenu, en Source comme en Visuel. L’appel est ajouté après le texte sélectionné ; ce texte est conservé. Annuler ferme l’éditeur sans changer le document.

En Visuel, un appel ouvre l’éditeur de sa note. Vous pouvez modifier le contenu, renommer l’identifiant avec un aperçu des occurrences touchées ou supprimer la note et ses appels après vérification. La suppression d’un seul appel conserve la définition. Chaque action s’annule en une étape.

Atteindre la définition sélectionne sa source. Revenir à l’appel, dans l’inspecteur Document, retrouve l’appel consulté. Un appel focalisé s’ouvre avec Entrée ; le lien de retour de la note rend le focus à son appel.

L’inspecteur Document présente les identifiants, leur nombre d’appels et les états manquant, sans appel ou doublonné. Les définitions manquantes ou doublonnées se corrigent en Source ; Balise ne choisit pas l’une d’elles à votre place.

Copier un appel emporte sa définition, même hors de la sélection. Si un collage rencontre un identifiant déjà utilisé avec un contenu différent, Balise propose de créer un identifiant libre, d’utiliser la note cible ou d’annuler. La note cible n’est jamais écrasée ; une cible doublonnée ne peut pas être choisie.

Les définitions multilignes et leurs appels sont protégés lors d’une édition visuelle voisine. Les appels à l’intérieur du code ou les marqueurs échappés ne sont pas interprétés. Les appels contenus dans une définition restent littéraux ; il n’y a pas d’interprétation récursive ni de renumérotation automatique.

Utiliser les raccourcis pendant la saisie

Dans le mode Visuel, Balise reconnaît certains marqueurs lorsqu’ils sont seuls au début d’un nouveau paragraphe. Tapez ensuite une espace ordinaire pour créer la structure correspondante : # à ###### pour les titres, - , * , + ou • pour les puces, 1. pour une liste numérotée, et - [ ] ou - [x] pour une tâche.

La transformation conserve le curseur à l’endroit où vous écrivez. Le marqueur, la mise en forme et le texte tapé sans pause s’annulent ensemble. Dans la source, les variantes de puce sont enregistrées sous la forme canonique -, et les listes numérotées commencent par 1..

La syntaxe doit être explicite : ## crée un titre de niveau 2, tandis que ##Titre reste un paragraphe littéral. Un marqueur précédé de \ n’est jamais transformé. Les raccourcis ne s’appliquent ni au collage, ni aux sélections, ni dans les tableaux, citations, blocs de code ou autres blocs techniques.

L’interrupteur Réglages > Markdown > Raccourcis de mise en forme pendant la saisie désactive ou réactive immédiatement cette aide dans toutes les fenêtres. Lorsqu’elle est désactivée, les paragraphes littéraux sont préservés comme tels au prochain chargement ; Balise ajoute au besoin l’échappement Markdown dans la source.

Indenter avec Tab

En Visuel, placez le curseur dans un élément de liste et utilisez Format > Augmenter le niveau (Tab) pour en faire un sous-élément de l’élément précédent. Le premier élément au premier niveau ne peut pas descendre, car aucun élément ne le précède. Utilisez Format > Diminuer le niveau (Maj-Tab) pour remonter un sous-élément d’un niveau. Sélectionnez plusieurs éléments de liste pour changer leur niveau ensemble.

Pour modifier les espaces en tête d’un paragraphe ordinaire, passez en Source. Placez le curseur avant le texte d’une ligne et appuyez sur Tab pour ajouter deux espaces en tête de ligne. Sélectionnez plusieurs lignes pour les indenter ensemble. Maj-Tab retire un niveau, soit une tabulation ou jusqu’à deux espaces. Chaque changement d’indentation en Source s’annule en une action.

Insérer une image

Insérer une image ouvre un sélecteur macOS. Si le document n’a pas encore été enregistré, Balise demande d’abord où le poser.

L’image choisie est copiée dans un dossier de ressources associé au document, et un lien relatif est inséré dans le Markdown. Votre document reste donc déplaçable avec ses images.

Coller et organiser les captures

Coller accepte une image bitmap seule depuis le presse-papiers en Source et en Visuel. La capture est stockée dans Nom.assets à côté du document ; un brouillon conserve ses images jusqu’à son premier enregistrement. Un collage textuel ou enrichi reste traité comme du texte. Une image supérieure à 20 Mio ou 40 millions de pixels est refusée avec un diagnostic.

Outils → Images du document… inventorie les références, montre les images locales et distingue les ressources manquantes, distantes ou inaccessibles. Choisissez un dossier et vérifiez les copies proposées avant de regrouper les images. Les homonymes reçoivent un nom distinct. Les originaux sont conservés ; annuler rétablit les références Markdown. Le dossier choisi peut devenir une préférence pour ce document ou pour son workspace. Si cette préférence n’est plus accessible, le collage annonce le repli vers Nom.assets.

Le déplacement des originaux dans la Corbeille est une option explicite, réservée aux ressources dont l’usage exclusif a été vérifié. Les ressources partagées ou incertaines restent copiées. Après un déplacement, Annuler peut restaurer les originaux tant que le document reste ouvert dans la session courante. Les copies regroupées persistent ; fermer le document termine cet historique d’annulation.

Enregistrer sous… copie les images locales accessibles dans le dossier de ressources du nouveau document et ajuste ses liens. L’ancien fichier et ses images restent intacts. Une image locale absente ou inaccessible doit être résolue avant de produire cette copie portable.

Réorganiser un tableau Markdown

Dans une cellule, le menu contextuel et l’inspecteur proposent de déplacer la ligne de données vers le haut ou le bas, ou la colonne vers la gauche ou la droite. L’en-tête reste en place ; l’alignement suit sa colonne. Les poignées permettent aussi le glisser-déposer. Chaque déplacement s’annule en une action.

Dimensions du tableau… montre les cellules non vides qui seront retirées avant de réduire le tableau. L’alignement gauche, centré ou droit modifie seulement le séparateur Markdown de la colonne. Les contenus et fins de ligne hors du tableau sont conservés. Une structure ambiguë reste à modifier en Source.

Renseigner les informations du document

L’inspecteur Document propose quatre champs simples : titre, date, statut et étiquettes. Vous pouvez les remplir sans connaître le YAML ; Balise crée le front matter si le document n’en contient pas encore.

Les autres métadonnées restent intactes. Si un champ utilise une structure complexe ou apparaît plusieurs fois, Balise vous conduit vers Source au lieu de le simplifier.

Contenu technique

Balise rend localement les blocs de code avec coloration syntaxique, les équations en ligne et en bloc, les diagrammes Mermaid, et les blocs clôturés math, latex ou tex. Les syntaxes $…$, $$…$$, \(…\), \[…\] et les environnements d’affichage AMS comme align, equation, gather ou multline sont reconnus. L’extension KaTeX mhchem rend aussi les formules chimiques \ce{…} et \pu{…}.

Régler les blocs de code et les mathématiques

Les blocs de code disposent d’un éditeur technique avec choix du langage, indentation de deux ou quatre espaces ou tabulation, numéros de ligne, retour visuel à la ligne et copie. Le langage par défaut peut suivre le dernier choix. Ces réglages sont globaux et ne réécrivent pas les blocs existants. Changer le langage d’un bloc conserve son fence, ses attributs et son corps, et forme une seule opération annulable. Une info string ambiguë reste modifiable en Source.

Le rendu mathématique local résout \label, \ref et \eqref dans l’ordre du document. La numérotation peut être désactivée, limitée aux environnements AMS, ou appliquée à toutes les équations en bloc. Un \tag manuel prime ; les environnements étoilés, \notag et \nonumber ne reçoivent pas de numéro automatique. Un environnement multiligne représente une seule équation et reçoit au plus un numéro ou tag. La numérotation et les références distinctes par ligne d’un même align ne sont pas prises en charge ; séparez les équations en blocs pour obtenir des identités navigables distinctes. Les labels absents, dupliqués ou attachés à une équation non numérotée sont signalés.

Balise comprend localement le sous-ensemble physics suivant : \qty, \abs, \norm, \dv, \pdv, \bra, \ket et \braket. Il ne charge pas le paquet LaTeX complet. Les macros définies par le document restent prioritaires et les limites KaTeX d’expansion et de taille continuent de s’appliquer. La préférence de numérotation est figée au lancement d’un export afin que HTML et PDF gardent le même sens que l’aperçu annoncé.

L’extension Coup d’œil s’exécute dans un processus sandboxé qui ne partage pas les préférences de Balise ; elle applique donc toujours la convention AMS. Cette limite est annoncée ici plutôt que de laisser croire que le choix « toutes les équations » est transmis à Finder.

Les macros globales définies avec \gdef restent disponibles dans les formules suivantes du même document. Lorsqu’une commande provenant d’un paquet LaTeX non pris en charge est rencontrée, Balise conserve un rendu partiel annoté au lieu de masquer toute la formule.

Un bloc technique sélectionné peut être modifié dans un éditeur dédié, copié comme source, ou supprimé.

Voir un aperçu dans Finder

Sélectionnez un fichier .md ou .markdown dans Finder, puis appuyez sur la barre d’espace. L’extension de Balise reprend le rendu clair ou sombre de l’application, y compris les tableaux, les équations KaTeX et les diagrammes Mermaid, sans connexion réseau.

Finder ne transmet que le fichier sélectionné à l’extension protégée par le bac à sable de macOS. Une image encodée dans le document peut donc être rendue, mais une image voisine liée par un chemin relatif peut rester inaccessible dans Coup d’œil ; ouvrez alors le document dans Balise pour voir toutes ses ressources locales. Les fichiers de plus de 2 Mo, ainsi que ceux qui contiennent un nombre exceptionnel de blocs techniques, affichent aussi un message invitant à les ouvrir dans Balise, afin de garder Coup d’œil réactif.

Naviguer dans un espace de travail

Ouvrir un dossier active un espace de travail. La navigation de gauche propose alors deux vues.

• Fichiers, avec des dossiers que vous pouvez déplier ou replier en cliquant leur rangée. Leur menu contextuel permet de les révéler dans Finder ou de copier leur chemin. Le filtre cherche récursivement les fichiers et dossiers ; le chemin du document actif se déplie automatiquement. Un fichier peut être ouvert dans l’onglet courant, un nouvel onglet ou une nouvelle fenêtre ;
• Plan, construit à partir des titres et de leurs niveaux.

Les fichiers de tableau .balisekanban, .balisekanban et, lorsque Tableau blanc est disponible, .balisewhiteboard apparaissent aussi dans Fichiers. Un clic ouvre leur vue visuelle dans le workspace de leur dossier ; Balise ne les présente jamais comme du Markdown ou comme du JSON à éditer.

Pour un fichier texte local présent, les menus de la vue Fichiers, des onglets, du titre de la fenêtre et des cartes Kanban présentent Copier le chemin, Copier le contenu du fichier, puis Révéler dans le Finder. La copie du contenu lit la version enregistrée sur disque : elle n’enregistre pas le document et n’inclut pas ses modifications en cours. L’action est masquée pour un dossier, un fichier absent ou une ressource non textuelle. Un contenu de plus de 8 Mio est refusé sans remplacer le presse-papiers.

Dans le mode Visuel, les liens sont actifs : une adresse externe s’ouvre dans l’application appropriée, une ancre fait défiler le document, un lien vers un autre Markdown l’ouvre dans l’espace courant, et un lien vers un autre type de fichier est confié à macOS.

Les dossiers vides restent visibles dans Fichiers, y compris après fermeture et réouverture du workspace. Ce comportement est partagé avec Kanban, Données et Mermaid.

Trier et organiser les fichiers

Le menu Options d’affichage, en bas à droite du panneau Fichiers, regroupe le tri par nom ou date de modification et l’ordre croissant ou décroissant. Le tri s’applique immédiatement. Nouveau dossier… se trouve dans le menu dossier en bas à gauche, après les commandes d’ouverture. Ces menus sont aussi disponibles dans les panneaux Fichiers de Données et Mermaid.

Fichiers masqués… ouvre l’édition des motifs d’exclusion, limités à ce workspace. Un aperçu indique les éléments concernés avant Appliquer. Annuler abandonne uniquement les changements de motifs. La palette recherche les fichiers dans les sous-dossiers et affiche leur chemin pour distinguer les homonymes.

Le Plan suit automatiquement la position du curseur et le défilement du document en mode Visuel. Le suivi est suspendu pendant une recherche dans le Plan pour préserver la sélection parmi les résultats.

Les menus de fichiers et dossiers proposent création, duplication, déplacement et mise à la Corbeille. Avant une opération affectant les liens, vérifiez les chemins source et destination, les références à modifier et les documents non enregistrés. Balise demande d’enregistrer les documents concernés ou permet d’annuler. Les fichiers modifiés depuis l’aperçu imposent son recalcul. La restauration depuis la Corbeille refuse d’écraser un élément recréé.

Le déplacement d’un dossier contenant des tableaux Kanban ou des tableaux blancs est refusé pour préserver leurs références. Le déplacement d’un fichier référencé dans un tableau blanc est également refusé. Les autres fichiers du workspace restent utilisables normalement.

Résumés locaux

Dans un espace de travail, Balise génère un résumé concis de deux phrases pour chaque fichier .md ou .markdown indexé et l’affiche sous son nom dans la vue Fichiers. Le résumé garde la langue du document et disparaît pendant sa régénération plutôt que d’être présenté comme actuel après une modification.

Les résumés sont produits par le modèle Apple Intelligence installé sur le Mac. Le contenu ne quitte pas l’ordinateur et aucun service distant ne sert de repli. Balise conserve le cache dans le dossier caché .baliseindex à la racine de l’espace de travail ; ce dossier ne remplace jamais le Markdown et n’est pas interprété comme du contenu. Un ancien .balise-index est renommé automatiquement lorsque le nouvel index n’existe pas encore.

Pour un fichier ouvert seul, Balise demande une fois l’accès explicite au dossier parent avant d’y créer .baliseindex. Annuler laisse le document éditable, mais sans résumé durable ; l’action Autoriser l’accès… reste disponible pour l’accorder plus tard. Supprimer .baliseindex retire uniquement les résumés et métadonnées reconstruisibles ; les fichiers Markdown restent inchangés.

Un document vide ou sans contenu sémantique n’est jamais envoyé au modèle. La vue Fichiers indique alors Aucun contenu à résumer.

Relisez les diffs avec vos outils Git habituels. Balise n’écrit jamais dans Git.

La vue Tableau blanc permet aussi de déposer les fichiers du workspace et de capturer une sélection Markdown comme carte d’extrait.

Rechercher et remplacer

La recherche porte sur le fichier actif et, quand un dossier est ouvert, sur tout l’espace de travail.

Les champs de recherche et de remplacement sont alignés sur deux lignes. À droite du champ de recherche, Aa active le respect de la casse, ab souligné recherche un mot entier et .* active les expressions régulières. Une infobulle décrit chaque option. Sans expression régulière, Mot entier considère les lettres Unicode, les marques d’accent, les nombres et _ comme faisant partie du mot. Les apostrophes et traits d’union le séparent : chat-chat contient deux mots chat, tandis que chats et mon_chat ne correspondent pas à chat entier. Les accents restent significatifs.

En mode Texte, motif et remplacement sont littéraux. En mode regex, utilisez $1, $2… pour reprendre les groupes capturés, $0 pour la correspondance entière et \$ pour insérer un dollar littéral. (?m) active les ancres de ligne et (?s) permet au point de couvrir les sauts de ligne. Une correspondance de longueur nulle insère du texte ; une requête vide n’effectue aucune opération. Une expression invalide affiche un diagnostic et laisse le document intact.

Les flèches parcourent les résultats et révèlent les sections repliées. Le compteur ajoute + si la recherche est incomplète. Les recherches coûteuses sont interrompues ; Annuler reste disponible pendant le calcul. Une nouvelle requête abandonne la précédente.

Dans un dossier ouvert, les résultats sont regroupés par fichier avec extrait et numéro de ligne. Les fichiers ouverts sont recherchés dans leur contenu courant, y compris les modifications non enregistrées ; les autres utilisent la version indexée. Un résultat dont le contenu a changé déclenche une nouvelle recherche.

Remplacer et Tout remplacer modifient uniquement le fichier actif. Tout remplacer forme une seule action annulable. Si le document change pendant la préparation, le remplacement est refusé. Les recherches limitées ne produisent jamais un remplacement partiel silencieux.

Diagnostics du document

L’inspecteur Document compte les titres, les liens et les blocs techniques, et signale un bloc non fermé, une note de bas de page sans définition, un bloc technique trop volumineux, un nombre excessif de blocs, un lien vers un fichier absent, une image absente, une ancre absente.

Chaque diagnostic est cliquable et vous ramène à l’endroit concerné en mode Source.

Renommer un fichier

Renommer un document depuis la liste de fichiers ouvre d’abord un aperçu complet : ancien et nouveau noms, déplacement éventuel du dossier de ressources, fichiers contenant des liens à mettre à jour, cible avant et après pour chacun, et numéro de ligne de chaque modification.

Le renommage et la mise à jour des liens sont ensuite appliqués ensemble. Si les fichiers ont changé depuis l’aperçu, l’opération est refusée et doit être recalculée.

Découper un Markdown en plusieurs fichiers

Choisissez Outils > Découper le Markdown…, ou utilisez le menu contextuel d’un fichier dans la barre latérale. La feuille compte les titres H1, H2 et H3, désactive les niveaux qui contiennent moins de deux titres et affiche les noms de tous les fichiers prévus. Dépliez Options de nommage pour utiliser les champs facultatifs Préfixe et Suffixe. Les deux valeurs sont placées avant l’extension et l’aperçu se met à jour avant toute écriture. Choisissez un niveau contenant au moins deux titres, puis confirmez avec Découper en N fichiers.

Chaque titre choisi commence un fichier et devient son H1. Les titres placés sous celui-ci remontent avec lui, tandis que les faux titres contenus dans un bloc de code sont ignorés. Le texte placé avant le premier titre, y compris le front matter, est conservé dans un fichier « Introduction ». Les nouveaux fichiers sont créés à côté de l’original sans écraser un fichier existant.

La case Déplacer l’original dans la Corbeille après la création est décochée au départ. Si vous l’activez, Balise déplace l’original dans la Corbeille récupérable seulement après avoir créé tous les fragments et réécrit les liens Markdown, wiki et les backlinks du dossier. Cette réécriture est automatique et n’ajoute pas de liste de liens à la feuille. Une modification externe ou une erreur annule l’ensemble de l’opération.

Demander à l’IA de travailler sur des documents

Activez Options expérimentales dans Réglages > Général, puis choisissez Outils > Demander à l’IA… depuis Markdown ou Kanban. Dans Réglages OpenAI…, saisissez votre clé API et choisissez Enregistrer la clé API. Balise conserve la clé dans le Trousseau macOS ; désactiver les options expérimentales la conserve. Cette fonction utilise une connexion Internet et votre accès API OpenAI. Elle ne remplace pas les résumés locaux Apple Intelligence.

Depuis Markdown, la liste commence par le document actif, y compris un brouillon non enregistré. Depuis Kanban, elle reprend les cartes Markdown sélectionnées. Ajouter des documents… permet de choisir d’autres fichiers .md ou .markdown. Retirez de la liste tout document que vous ne souhaitez pas envoyer. Au lancement, Balise lit le texte actuel des documents ouverts, y compris les modifications non enregistrées ; il lit sur le disque les autres fichiers. Si le même fichier a plusieurs versions non enregistrées différentes dans plusieurs fenêtres, gardez une seule version ouverte avant de réessayer.

Choisir et conserver une consigne

Écrivez votre demande dans Consigne, ou chargez l’un des six Modèles de consignes : Résumer, Comparer, Décisions et actions, Questions de clarification, Synthèse thématique et Brief pour un agent. Vous pouvez modifier le texte chargé avant de lancer la demande. Charger un modèle, une consigne récente ou un favori ne déclenche aucun envoi.

Consignes récentes conserve les dix dernières consignes lancées, de la plus récente à la plus ancienne, sans doublons identiques. Le menu de chaque entrée permet de la charger ou de la retirer ; Effacer les consignes récentes vide la liste.

Dans Consignes favorites, choisissez Ajouter la consigne aux favoris… et donnez-lui un nom. Gérer les consignes favorites… permet de renommer un favori, de modifier son texte ou de le supprimer. Utiliser la consigne actuelle copie votre demande dans l’éditeur du favori ; choisissez ensuite Enregistrer les modifications pour la conserver. La bibliothèque de consignes reste sur votre Mac après la relance de Balise. Elle conserve vos consignes, sans recopier les documents sources ni la clé API.

Générer et conserver la réponse

Avant de choisir Générer, relisez la liste des documents et la consigne. Balise envoie leurs noms et leur texte à OpenAI avec votre consigne, en utilisant GPT-6.1 Sol. Balise n’ajoute pas les chemins locaux complets à l’envoi et n’y joint aucune image ni aucun fichier lié. La limite de 512 Kio couvre les noms, les textes et la consigne réunis ; retirez un document ou raccourcissez la demande si Balise la dépasse.

La réponse arrive progressivement dans un nouveau brouillon Markdown en mode Source. Pendant la génération, vous pouvez lire et copier le texte ; l’édition et l’enregistrement attendent la fin. Choisissez Arrêter pour interrompre la réponse et conserver ce qui est déjà reçu. Une interruption, une erreur ou une réponse incomplète laisse un résultat marqué comme partiel.

À la fin, la section Provenance indique le fournisseur, le modèle, la date, l’état de la réponse, la consigne et les documents utilisés. Les liens locaux de cette section restent dans votre brouillon. Relisez la réponse et vérifiez les citations contre vos documents avant de l’utiliser. Les fichiers sources ne changent pas. Choisissez Fichier > Enregistrer pour conserver le nouveau brouillon, y compris une réponse partielle.

Produire un diagramme Mermaid avec OpenAI

Dans Markdown, en mode Source ou Visuel, choisissez Outils > Générer un diagramme avec OpenAI… après avoir activé les options expérimentales. La même commande figure dans le menu Outils de la barre d’outils et dans la palette de commandes. Elle utilise votre clé API OpenAI et GPT-6.1 Sol.

Sélectionnez du texte avant d’ouvrir la commande pour en faire un diagramme. Après génération et vérification, Balise insère un nouveau bloc Mermaid après le dernier bloc complet concerné par la sélection. Le texte sélectionné reste en place, même si la sélection ne couvre qu’une partie d’un paragraphe ou d’une liste. L’insertion forme une seule modification annulable et n’enregistre pas le fichier.

Sans sélection, Balise utilise le document Markdown entier et ouvre le résultat dans un nouveau brouillon Mermaid distinct. Le Markdown d’origine ne change pas. Vous choisissez ensuite où enregistrer le brouillon .mmd. Pour un document en lecture seule, retirez la sélection et rouvrez la commande pour utiliser ce parcours distinct.

Relisez le contexte affiché dans la fenêtre avant l’envoi. Dans Type de diagramme, laissez Automatique ou choisissez une famille précise. Ajoutez une Consigne (facultative) pour orienter le résultat ; laissez ce champ vide pour utiliser la demande générale de diagramme fidèle au texte. Choisissez Générer pour envoyer ce contexte et la consigne à OpenAI. Balise ne charge pas les images ni les fichiers liés.

Balise attend la réponse complète, puis vérifie le code avec son moteur Mermaid local avant l’insertion ou l’ouverture du résultat. Ce contrôle vérifie le rendu ; relisez le sens du diagramme par rapport à votre texte. Si le document source a changé entre-temps, Balise refuse l’insertion. Le code reste disponible pour un brouillon distinct.

Arrêter interrompt la génération ou la vérification en conservant le code reçu. En cas d’arrêt, d’erreur ou de réponse incomplète, ouvrez Code généré, puis choisissez Copier le code ou Ouvrir comme brouillon Mermaid avant de fermer la fenêtre pour conserver ce résultat. Un code non validé s’ouvre en Source, où vous pouvez le corriger. Balise ne répare pas la réponse et ne relance aucune requête automatiquement. Pour refaire une demande, choisissez vous-même Générer ; si le texte source a changé, fermez et rouvrez l’outil pour relire son nouveau contexte.

Copier et coller

Une copie depuis Markdown place plusieurs formes dans le presse-papiers : du Markdown, du texte brut, du HTML et du RTF. La copie visuelle reconvertit la sélection ; elle ne garantit pas une reproduction exacte de la source. Les échanges avec un navigateur, un assistant conversationnel ou un éditeur de texte riche fonctionnent donc sans réglage.

Transmettre le contexte à un assistant

Choisissez Copier le contexte dans la barre d’outils, puis utilisez le collage normal (⌘V) dans Codex, Claude ou votre assistant habituel. Balise copie le dernier résumé déjà préparé, suivi d’une référence au fichier avec son chemin complet. Dans Codex, cette référence apparaît sous le nom du fichier et reste cliquable. Dans le mode Code de Claude pour macOS, les noms apparaissent comme des références natives. Gardez Balise ouvert pendant le passage dans Claude et le collage. La même copie s’adapte automatiquement lorsque vous revenez dans Codex. Dans une destination en texte brut, le chemin complet reste visible, sans syntaxe de lien Markdown. Le rendu dans les autres applications dépend de leur prise en charge des liens locaux.

Balise n’ajoute aucun titre « Résumé », ne copie pas la source intégrale et ne joint pas le fichier. Le bouton demande un fichier déjà enregistré pour pouvoir fournir son chemin. Sans résumé disponible, la copie contient seulement sa référence. Si vous avez des modifications non enregistrées, le résumé de la version enregistrée reste disponible avec une indication de cet état. La copie ne génère pas de nouveau résumé et n’enregistre pas le document.

Si vous voyez seulement un nom sans chemin dans une autre application, passez dans un éditeur de texte pour retrouver le chemin complet. La référence désigne un fichier sur votre Mac ; l’assistant doit pouvoir accéder à cet emplacement pour en lire le contenu.

Coller dans Markdown

Au collage, Balise privilégie le Markdown explicite. S’il reçoit du HTML ou du RTF, il le convertit vers un sous-ensemble Markdown prudent et retire les scripts, styles, cadres et gestionnaires d’événements.

Après avoir copié une plage dans Données, choisissez Édition > Coller comme tableau Markdown…. L’aperçu confirme les lignes et colonnes, permet de choisir l’en-tête, l’alignement de chaque colonne et le traitement des retours internes, puis surligne les cellules qui seront échappées. La première ligne sert d’en-tête par défaut. Les barres verticales sont protégées, les retours peuvent devenir <br>, et une plage de plus de 1 000 cellules est refusée sans modifier le document. Un TSV irrégulier ou ambigu reste disponible par le collage brut normal.

Modifier > Coller et adapter le style (⌥⇧⌘V) force un collage en texte brut.

Imprimer

Balise imprime la vue rendue, équations et diagrammes compris.

Ce que cette surface ne fait pas

• Balise n’écrit jamais dans Git : pas de commit, pas d’envoi vers un dépôt distant.
• Une ouverture suivie d’un enregistrement sans édition conserve la source. Une édition visuelle peut toutefois transformer des syntaxes étendues, même dans un paragraphe voisin.
• Le mode Visuel n’ajoute aucun style qui ne s’exprime pas en Markdown.

La vue Kanban a sa propre page : La vue Kanban.

Limites des syntaxes étendues

L’audit du corpus Markdown a constaté qu’une édition visuelle voisine peut transformer le front matter. Les listes de définitions reconnues sont protégées. Pour ces documents, utilisez Source et contrôlez le résultat avant de sauvegarder. La conservation sans édition ne garantit pas la conservation après une édition visuelle ou un collage. Dans les cas mixtes testés, le collage entre documents Balise peut aussi dégrader des diagrammes Mermaid et des équations voisins.

Listes de définitions

Les listes composées d’un terme suivi de lignes commençant par : affichent les termes et leurs définitions séparément. Plusieurs définitions et les paragraphes indentés restent dans leur bloc source protégé. Le collage d’une liste HTML conserve les associations entre termes et définitions.

Les listes existantes restent affichées en Visuel et dans Coup d’œil. Pour créer ou modifier une liste, utilisez le mode Source. Il n’y a pas de commande dédiée ni d’inspecteur d’édition.

Voir ce parcours de bout en bout : Tenir la documentation d’un dépôt.