Balise ouvre des fichiers qui existaient avant lui et qui continueront d’exister après. Cette page décrit ce qui se passe à l’entrée et à la sortie.
Créer un fichier
Fichier > Nouveau fichier (⌘N) ouvre un centre de création. Vous y choisissez explicitement ce que vous commencez.
- un document Markdown vide ;
- un document Markdown basé sur un brief pour un agent, une fonctionnalité, un rapport de bogue, un README, une décision de projet ou un compte rendu ;
- un fichier de données CSV ;
- un diagramme Mermaid.
Chaque création ouvre sa propre fenêtre. Vous pouvez donc garder plusieurs documents, jeux de données et diagrammes ouverts en parallèle.
Utiliser un modèle Markdown
Dans Nouveau fichier > Markdown, choisissez Modèles Balise ou Mes modèles. Une recherche permet de retrouver un modèle et l’étoile le place en tête de sa liste. Un clic affiche son aperçu ; un double-clic crée directement le document.
Les modèles Balise proposent une Trame et un Exemple rempli. Créer le document utilise toujours la trame, même lorsque vous consultez l’exemple. L’exemple n’est pas ajouté au document créé.
Pour réutiliser votre propre structure, ouvrez un document Markdown puis choisissez Fichier > Enregistrer une copie comme modèle…. Balise enregistre une copie indépendante au format .md, sans enregistrer ni remplacer le document de départ.
Le menu de dossier de la galerie permet de choisir un autre dossier de modèles, de l’afficher dans le Finder ou de l’actualiser. Les fichiers .md et .markdown de ce dossier apparaissent dans Mes modèles. Vous pouvez les modifier dans un autre éditeur ; la galerie les recharge au retour dans Balise.
Modifier le modèle ouvre son fichier d’origine. Créer le document ouvre une copie indépendante : les modifications de cette copie ne changent pas le modèle. Revenir au dossier par défaut ne supprime aucun fichier de l’ancien dossier.
Ouvrir les exemples
Choisissez Aide > Afficher les exemples Balise. Balise ouvre une nouvelle fenêtre avec une copie modifiable des exemples originaux fournis par la version installée. Les exemples suivent la langue choisie dans Réglages > Général > Langue.
Vous pouvez les modifier pour essayer l’édition Markdown, les données et les diagrammes. La prochaine utilisation de Afficher les exemples Balise repart des originaux, même si vous avez modifié un essai précédent. Après une mise à jour de Balise, cette commande utilise les exemples fournis par la nouvelle version. Elle ne télécharge pas de contenu sur Internet.
Vos essais précédents restent dans leurs propres copies ; ouvrir de nouveaux exemples ne les écrase pas. Pour conserver un document à l’endroit de votre choix, utilisez Fichier > Enregistrer sous… (⇧⌘S). Pour reprendre un essai enregistré, rouvrez son fichier avec Fichier > Ouvrir… (⌘O).
Ouvrir un fichier
Fichier > Ouvrir… (⌘O) accepte plusieurs sélections à la fois et crée une fenêtre par fichier. Vous pouvez aussi glisser un fichier sur l’icône de Balise, l’ouvrir depuis le Finder, ou lancer open -a Balise fichier.csv depuis un terminal.
Ouvrir un dossier est différent : Balise en fait un espace de travail Markdown. Il indexe les fichiers compatibles qu’il contient, et vous naviguez ensuite entre eux sans repasser par le Finder.
Les dossiers dont le nom se termine par .assets sont masqués dans la navigation. Ils conservent les images et autres fichiers associés ; les liens de vos documents continuent de les utiliser. Pour consulter ces dossiers, ouvrez-les dans le Finder.
Importer un fichier
Fichier > Importer… convertit un document externe vers une nouvelle copie Markdown ou CSV. Un aperçu montre le résultat avant de créer le document. La copie reste non enregistrée et porte le suffixe converti ; vous choisissez son emplacement au premier enregistrement.
Les documents structurés peuvent proposer Markdown et CSV. Les fichiers multi-feuilles permettent d’importer une feuille ou toutes les feuilles. Les images locales suivent la copie Markdown dans son dossier d’assets.
La liste exacte des formats et les limites de sécurité se trouvent dans Formats et conversions.
Retrouver vos emplacements
Le menu d’emplacements de la barre d’outils garde vos dossiers et fichiers fréquents. Il permet d’ouvrir une cible, d’ajouter le fichier ou le dossier courant aux Favoris, puis de renommer, réordonner, reconnecter ou retirer un favori.
Les favoris sont séparés par espace : Markdown, Données et Mermaid ont chacun leur liste. Seul Markdown accepte des dossiers complets.
Dans le menu d’emplacements, Ouvrir le dossier parent permet de remonter d’un niveau depuis le dossier affiché. L’action est désactivée lorsqu’aucun dossier parent n’est disponible.
Enregistrer
Fichier > Enregistrer (⌘S) écrit directement dans le fichier standard. Il n’y a pas d’étape d’export intermédiaire : le document que vous éditez est le fichier que vos autres outils liront.
Fichier > Enregistrer sous… (⇧⌘S) écrit une copie ailleurs et continue la session sur cette copie.
Si vous ouvrez un fichier et l’enregistrez sans rien changer, le fichier reste identique, octet pour octet.
Quand le fichier a changé pendant que vous travailliez
Avant de remplacer un fichier, Balise vérifie qu’il n’a pas changé sur le disque depuis son ouverture. Si une autre application l’a modifié, l’enregistrement est refusé et un comparateur s’ouvre.
Vous y voyez côte à côte la version enregistrée de référence, votre version locale et la version qui se trouve sur le disque. Trois issues vous sont proposées : garder le conflit et ne rien faire, recharger la version du disque, ou enregistrer votre version sous un nouveau nom.
Aucune de ces actions ne remplace la version du disque sans que vous l’ayez demandée. Le détail est dans Quand l’enregistrement est refusé.
Fermer sans perdre
Un onglet ou une fenêtre qui contient des modifications non enregistrées le signale. Avant de fermer, Balise propose d’enregistrer, d’abandonner ou d’annuler.
En parallèle, une copie de récupération est écrite périodiquement pour les documents modifiés. Elle sert uniquement en cas d’interruption brutale, et elle ne remplace jamais votre fichier. Voir Versions locales et récupération.
Ce que cette surface ne fait pas
- Balise n’enregistre pas automatiquement par-dessus votre fichier : ⌘S reste votre décision.
- Balise ne remplace jamais un fichier importé ; il crée une copie non enregistrée.
- Balise ne fusionne pas deux versions d’un fichier en conflit ; il vous montre les trois états et vous laisse choisir.
- Balise ne synchronise rien avec un service distant.