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.

Touche	Effet
↓ ↑	nœud suivant / précédent au même niveau, en traversant les branches
←	remonte au parent
→	déplie si replié ; sinon descend au premier enfant
Espace	plie ou déplie le nœud actif
Alt+Début	referme toute la profondeur ; le nœud actif reste ouvert
Alt+Fin	déplie tout depuis le nœud actif
Fin	édite le texte, curseur à la fin
Début	édite le texte, curseur au début
Entrée	nouveau frère en dessous
Shift+Entrée	nouveau frère au-dessus
Tab	nouveau dernier enfant
Shift+Tab	intercale un parent entre le nœud et son parent actuel
Suppr	supprime le nœud et toute sa descendance
Ctrl+←	sort d'un niveau : le nœud devient le dernier frère de son parent
Ctrl+→	rentre d'un niveau : le nœud devient le dernier enfant de son frère précédent
Ctrl+↑ Ctrl+↓	déplace le nœud dans sa fratrie
Ctrl+1 … Ctrl+6	donne au nœud ce niveau de titre
Ctrl+Z / Ctrl+Y	annule / refait

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.

Pendant l'édition, avec du texte sélectionné	Effet
Ctrl+B	entoure la sélection de **, ou les retire s'ils y sont ou l'encadrent
Ctrl+I	entoure la sélection de *, ou l'enlève s'il y est ou l'encadre

• 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

Geste	Effet
clic ou appui sur un nœud replié	le sélectionne et le déplie
clic ou appui sur un nœud déplié non sélectionné	le sélectionne seulement
clic ou appui sur le nœud déjà sélectionné	le replie
clic ou appui sur la pastille	plie ou déplie, toujours
clic ou appui sur une case à cocher	la coche ou la décoche
double-clic, double-appui	édite le texte
molette	zoom, centré sur le curseur
glisser, un doigt	déplace la carte
pincer, deux doigts	zoome, centré entre les doigts

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.

Dans le fichier	Dans la carte
le nom du fichier	la racine, toujours — jamais un titre du corps
# Titre	un nœud et un niveau de profondeur : ce qui suit lui appartient
- texte / * texte	un nœud ; la puce ne s'affiche pas
indentation d'une puce	la profondeur dans l'arbre
1. texte	un nœud dont le numéro reste visible
[x] / [ ] en tête	une case à cocher, cliquable
ligne indentée sans puce	la suite du texte du nœud au-dessus
ligne sans puce ni titre	un nœud, sans plus
bloc de code ```	entièrement ignoré, y compris les # qu'il contient
**gras** *italique*	mis en forme dans le nœud, marqueurs masqués
`code` ~~barré~~ ==surligné==	de même
[[liens]] #tags	affichés bruts, avec leur syntaxe

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.