MindEdit

Un plugin Obsidian qui affiche et édite une note Markdown sous forme de mindmap, avec certains raccourcis usuels de clavier de FreePlane.

La note reste un fichier .md ordinaire, lisible et modifiable normalement. La mindmap n'est qu'une autre façon de la regarder — jamais un second format, jamais une seconde note.

Installation

1. Télécharger les trois fichiers de ce dossier :

   • manifest.json
   • main.js
   • styles.css

2. Dans votre coffre Obsidian, créer le dossier :

   .obsidian/plugins/mindedit/
   

3. Y placer les trois fichiers.

4. Redémarrer Obsidian, ou aller dans Paramètres → Modules complémentaires → Recharger, puis activer MindEdit.

Utilisation

Basculer entre Markdown et mindmap

L'icône réseau dans le ruban de gauche, ou la palette de commandes → « Basculer entre Markdown et mindmap ».

Le basculement écrit mindmap: true dans le frontmatter de la note — le bloc de métadonnées entre deux lignes --- en tête de fichier. C'est la seule chose qu'il touche : le corps du texte n'est jamais modifié par le basculement. Une note portant ce drapeau se rouvrira directement en mindmap.

Clavier

La carte doit avoir le focus : clique une fois dedans.

Les quatre Ctrl+flèche emportent toute la descendance du nœud. Les frères qui le suivaient, eux, ne bougent pas : il part seul avec sa branche.

Une seule règle gouverne tous les déplacements : un nœud garde sa nature. Une puce reste une puce, un titre reste un titre. Tout ce qui exigerait une conversion — sortir une puce de sous un titre en ferait un titre — est refusé, en silence. Changer la nature d'un nœud reste un geste délibéré, celui de Ctrl+1…Ctrl+6.

Ctrl+↑ et Ctrl+↓ valent donc aussi pour les titres : réordonner deux chapitres ne convertit rien.

Pendant l'édition d'un texte : Entrée valide, Échap annule, cliquer ailleurs valide.

• Les espaces au bord de la sélection restent hors des marqueurs : **gras ** ne s'afficherait pas en gras.
• La série d'étoiles se lit comme au rendu : une pour l'italique, deux pour le gras, trois pour les deux. Chaque touche ne bascule que sa part — Ctrl+I sur **gras** donne ***gras***, sans perdre le gras.
• Le résultat reste sélectionné, marqueurs compris : refaire la même touche défait aussitôt, et Ctrl+B puis Ctrl+I donne du gras italique.
• Les étoiles sont cherchées dans la sélection et juste autour : un double-clic sur un mot en gras ne sélectionne que le mot, sans ses **, et Ctrl+B les retire quand même. Le retrait marche donc encore le lendemain, quand plus rien n'est annulable.
• On ne tient compte que des étoiles présentes des deux côtés : une étoile collée d'un seul côté n'encadre rien.
• Ctrl+Z annule l'ajout dans le texte, comme une frappe.
• Sans sélection, rien ne se passe.

Un nœud qu'on vient de créer s'ouvre aussitôt en saisie. Si on l'abandonne par Échap ou en le laissant vide, sa création est annulée — pas de puce vide oubliée dans le fichier.

Souris et tactile

Souris, doigt et stylet passent par le même chemin de code : les Pointer Events ne les distinguent pas. Un appui tolère quelques pixels de tremblement avant de devenir un déplacement, sans quoi désigner un nœud au doigt ferait frémir la carte.

La logique du clic n'est pas une bascule ordinaire, et c'est délibéré. Déplier ne détruit rien ; replier détruit ta vue. Le geste non destructeur est donc immédiat, le destructeur exige que le nœud soit déjà sélectionné. C'est ce qui permet de sélectionner un parent sans le refermer au passage.

Comment MindEdit lit ton Markdown

C'est le point à comprendre pour que la carte ait la forme voulue.

Le niveau de titre (#, ##, ###) fait donc deux choses à la fois : il stylise, et il ouvre un cran de profondeur. Le donner reste ton geste, avec Ctrl+1…Ctrl+6.

La mise en forme est affichée, jamais absorbée. Un nœud montre **gras** en gras, mais dès que tu l'édites, le texte redevient le Markdown littéral. Sans ça, valider une retouche écrirait gras dans ton fichier et le balisage disparaîtrait sans un mot.

Exemple

# Contrat

* Cette mission a pour objectif de refondre le site vitrine…
* Indicateurs de réussite :
   * le tunnel de commande reste disponible pendant toute la bascule
   * les pages se chargent en moins d'une seconde sur mobile

Contrat.md  (racine = nom du fichier)
└── Contrat  [titre]
    ├── Cette mission a pour objectif de refondre le site vitrine…
    └── Indicateurs de réussite :
        ├── le tunnel de commande reste disponible pendant toute la bascule
        └── les pages se chargent en moins d'une seconde sur mobile

Licence

GPL-3.0-or-later

Ce choix est délibéré : tout ce qui dérive de ce code doit rester libre.