Éditeur Markdown | Sutram Blog

L'editeur Markdown de Sutram vous permet de creer et de modifier des documents de texte formate directement dans le navigateur. C'est un editeur visuel (WYSIWYG) ou vous voyez le resultat final pendant que vous editez, sans avoir besoin de connaitre la syntaxe markdown.

Creer un fichier Markdown

Naviguez vers un dossier dans votre projet
Cliquez sur le menu ⋮ (trois points) dans le coin superieur droit
Selectionnez Ajouter un fichier Markdown
Saisissez un nom pour le fichier
L'editeur s'ouvre automatiquement avec le titre deja insere

Remarque : Cette option n'apparait que dans les dossiers (pas a la racine du projet) et necessite un forfait PRO ou superieur.

Modifier un fichier existant

Cliquez sur n'importe quel fichier .md dans la liste de contenu
Dans la visualisation, cliquez sur le bouton Modifier ou sur l'icone d'agrandissement
L'editeur s'ouvre avec le contenu actuel du fichier

Important : Pour modifier, vous devez effectuer le « check-out » du fichier. Cela reserve le fichier pour vous, empechant d'autres personnes de le modifier en meme temps.

Barre d'outils

La barre d'outils se trouve en haut de l'editeur. Chaque bouton applique une mise en forme specifique.

Mise en forme du texte

Bouton	Nom	Comportement
B	Gras	Bascule - Cliquez une fois pour activer, cliquez a nouveau pour desactiver. Fonctionne avec du texte selectionne ou a la position actuelle du curseur. Raccourci : `Ctrl+B` (Windows) ou `Cmd+B` (Mac)
I	Italique	Bascule - Fonctionne comme le gras. Raccourci : `Ctrl+I` ou `Cmd+I`
S	Barre	Bascule - Ajoute ou supprime une ligne sur le texte selectionne
`<>`	Code en ligne	Bascule - Met en forme le texte en tant que code (police a espacement fixe)

Titres

Bouton	Nom	Comportement
H1	Titre 1	Bascule - Transforme la ligne actuelle en grand titre. Si c'est deja un H1, revient en paragraphe normal
H2	Titre 2	Bascule - Titre moyen. Si c'est deja un H2, revient en paragraphe
H3	Titre 3	Bascule - Petit titre. Si c'est deja un H3, revient en paragraphe

Astuce : Positionnez le curseur sur n'importe quelle ligne et cliquez sur H1, H2 ou H3 pour la transformer en titre.

Listes

Bouton	Nom	Comportement
•	Liste a puces	Bascule - Cree une liste avec des points. Cliquez a nouveau pour revenir en paragraphe
1.	Liste numerotee	Bascule - Cree une liste numerotee automatiquement

Creer des sous-elements : Dans une liste, appuyez sur Tab pour creer un sous-element (indenter) ou Shift+Tab pour revenir au niveau precedent.

Blocs speciaux

Bouton	Nom	Comportement
"	Citation	Bascule - Cree un bloc de citation (avec barre laterale). Utile pour mettre en evidence des passages importants
`[ ]`	Bloc de code	Insertion - Cree une zone pour du code sur plusieurs lignes

Tableaux

Le bouton de tableau (icone de grille) ouvre un menu deroulant avec toutes les options pour creer et modifier des tableaux.

Option	Comportement
Inserer un tableau	Cree un tableau 3x3 a la position du curseur
Ajouter une ligne au-dessus	Insere une nouvelle ligne au-dessus de la ligne actuelle
Ajouter une ligne en dessous	Insere une nouvelle ligne en dessous de la ligne actuelle
Ajouter une colonne a gauche	Insere une nouvelle colonne a gauche de la colonne actuelle
Ajouter une colonne a droite	Insere une nouvelle colonne a droite de la colonne actuelle
Supprimer la ligne	Supprime la ligne ou se trouve le curseur
Supprimer la colonne	Supprime la colonne ou se trouve le curseur
Supprimer le tableau	Supprime le tableau entier

Comment utiliser les tableaux :

Creer un tableau : Cliquez sur le bouton de tableau et selectionnez « Inserer un tableau ». Un tableau 3x3 sera cree.
Modifier les cellules : Cliquez sur n'importe quelle cellule et saisissez le contenu. Utilisez Tab pour passer a la cellule suivante ou Shift+Tab pour revenir en arriere.
Ajouter des lignes/colonnes : Positionnez le curseur dans la cellule de reference, cliquez sur le bouton de tableau et choisissez ou ajouter (au-dessus, en dessous, a gauche ou a droite).
Supprimer des lignes/colonnes : Positionnez le curseur sur la ligne ou la colonne que vous souhaitez supprimer, cliquez sur le bouton de tableau et choisissez « Supprimer la ligne » ou « Supprimer la colonne ».
Supprimer le tableau entier : Avec le curseur dans n'importe quelle cellule du tableau, cliquez sur le bouton de tableau et choisissez « Supprimer le tableau ».

Astuce : La premiere ligne du tableau est automatiquement formatee comme en-tete (texte en gras avec fond mis en evidence).

Liens et medias

Bouton	Nom	Comportement
🔗 (globe)	Lien externe	Insertion - Ouvre une boite pour saisir une URL. Cree un lien cliquable dans le texte
🔗 (chaine)	Lien web du projet	Selection - Affiche les liens web enregistres dans le dossier actuel pour que vous les choisissiez
🖼️ (paysage)	Image depuis URL	Insertion - Ouvre une boite pour coller l'adresse d'une image d'internet
🖼️ (dossier)	Image du projet	Selection - Affiche les images du dossier actuel pour que vous les choisissiez et les inseriez
📹	Video du projet	Selection - Affiche les liens video du dossier actuel (YouTube, Vimeo, etc.)
🎵	Audio du projet	Selection - Affiche les liens audio du dossier actuel (SoundCloud, Spotify, etc.)

Comment inserer des liens et des medias

Lien externe (n'importe quelle URL) :

Selectionnez le texte qui sera le lien (optionnel)
Cliquez sur le bouton du globe
Saisissez ou collez l'URL
Si vous n'avez pas selectionne de texte, saisissez le texte du lien

Lien web du projet :

Cliquez sur le bouton de la chaine
Une liste affiche les liens enregistres dans le dossier
Cliquez sur le lien souhaite pour l'inserer

Image du projet :

Cliquez sur le bouton du dossier avec image
Une liste affiche les images du dossier
Cliquez sur l'image souhaitee pour l'inserer

Video ou audio :

Cliquez sur le bouton video ou audio
Choisissez dans la liste des medias du dossier
Le lien est insere dans le document

Comment supprimer des liens et des medias

Pour supprimer un lien, une image, une video ou un audio insere :

Positionnez le curseur a la fin du lien/media
Appuyez sur Retour arriere (ou Supprimer) pour effacer caractere par caractere
Ou selectionnez l'element entier (cliquez et faites glisser) et appuyez sur Supprimer ou Retour arriere

Astuce : Pour les liens textuels, vous pouvez egalement selectionner le texte du lien et simplement taper quelque chose de nouveau pour le remplacer.

Sauvegarde automatique

L'editeur sauvegarde votre travail automatiquement toutes les 60 secondes, a condition qu'il y ait des modifications non sauvegardees. Vous verrez brievement un indicateur « Sauvegarde en cours... » lorsque cela se produit.

Important : La sauvegarde automatique sauvegarde un brouillon. Pour que les autres personnes voient vos modifications, vous devez publier le fichier.

Publication des modifications

Lorsque vous avez fini de modifier :

Cliquez sur le bouton Terminer l'edition (coin superieur droit)
Le fichier est publie et libere pour les autres utilisateurs
Vos modifications deviennent visibles pour toute l'equipe

Remarque : Si vous quittez l'editeur sans terminer, vos modifications sont sauvegardees en tant que brouillon, mais le fichier reste reserve pour vous (check-out).

Assistant IA pour les sections

L'editeur inclut un assistant d'intelligence artificielle qui peut aider a ameliorer, resumer ou developper des sections de votre document. Les actions IA sont disponibles sur n'importe quel titre (H1, H2, H3, etc.).

Comment y acceder

Il existe deux facons d'acceder aux actions IA :

Clic droit sur un titre : Un menu contextuel apparait avec les options disponibles
Bouton sur le titre : En passant la souris sur un titre, un bouton ⋮ apparait a droite. Cliquez dessus pour voir les options

Actions disponibles

Action	Description
Resumer la section	Condense le contenu de la section, en conservant les points principaux
Developper la section	Ajoute plus de details et de profondeur au contenu existant
Ameliorer la section	Ameliore la qualite de l'ecriture (clarte, fluidite, grammaire)
Generer un resume executif	Cree un resume de haut niveau du document (disponible uniquement sur les titres H1)
Supprimer la section	Supprime la section et tout son contenu (n'utilise pas l'IA)

Flux d'utilisation

Choisissez une action : Faites un clic droit sur le titre ou utilisez le bouton ⋮ et selectionnez l'action souhaitee
Attendez le traitement : Un indicateur de chargement apparait pendant que l'IA traite. Vous pouvez annuler a tout moment
Examinez le resultat : Un panneau de comparaison montre le texte original (a gauche) et la suggestion de l'IA (a droite), cote a cote
Decidez : Cliquez sur Appliquer pour accepter la suggestion ou Annuler pour la rejeter

Aucune modification n'est effectuee sans votre approbation. Vous visualisez toujours le resultat avant de l'appliquer.

Resume executif (TLDR)

L'action « Generer un resume executif » fonctionne differemment des autres :

Disponible uniquement sur les titres H1
Au lieu de remplacer le contenu, insere une nouvelle section juste en dessous du H1
Le titre de la section est localise dans la langue du document (par ex. : « Resume executif (TLDR) » en francais)

Supprimer une section

La suppression de section n'utilise pas l'IA et fonctionne ainsi :

Une fenetre de confirmation montre le contenu qui sera supprime
Cliquez sur Supprimer la section pour confirmer ou Annuler pour conserver

Attention : La suppression retire la section entiere (titre et tout le contenu jusqu'au titre suivant). Cette action ne peut pas etre annulee directement — utilisez le bouton Annuler (version precedente) pour restaurer le document.

Bouton Annuler (version precedente)

Le bouton Annuler apparait lorsqu'il existe une version precedente du fichier. Cliquer dessus :

Restaure la version precedente complete du fichier
La version actuelle devient la nouvelle sauvegarde

Attention : Cette annulation restaure le fichier entier a la version precedente, pas seulement la derniere saisie. Pour annuler une saisie recente, utilisez Ctrl+Z (Windows) ou Cmd+Z (Mac).

Telecharger le fichier

Dans la liste de contenu, cliquez sur le menu ⋮ du fichier markdown pour voir les options :

Telecharger : Telecharge uniquement le fichier .md
Telecharger avec les images : Telecharge un fichier ZIP contenant le markdown et toutes les images Sutram presentes dans le document. Les liens des images sont convertis en chemins relatifs, rendant le package portable.

Remarque : L'option « Telecharger avec les images » n'apparait que pour les fichiers publies. S'il n'y a pas d'images Sutram dans le document, un message vous informera que vous devez utiliser l'option de telechargement normale.

Raccourcis clavier

Raccourci	Action
`Ctrl/Cmd + Z`	Annuler la derniere saisie
`Ctrl/Cmd + Shift + Z`	Retablir
`Ctrl/Cmd + B`	Gras
`Ctrl/Cmd + I`	Italique
`Enter`	Nouveau paragraphe
`Shift + Enter`	Saut de ligne (meme paragraphe)
`Tab`	Indenter un element de liste
`Shift + Tab`	Supprimer l'indentation d'un element de liste

Mode commentaires

L'editeur markdown inclut un mode commentaires integre qui permet de visualiser, gerer et repositionner les marqueurs de commentaires pendant l'edition du document.

Deux modes de fonctionnement

L'editeur alterne entre deux modes :

Mode	Description
Edition (par defaut)	Editeur WYSIWYG Milkdown normal, sans marqueurs visibles
Commentaires	Apercu rendu avec calque de commentaires et panneau lateral

Acceder au mode commentaires

Dans l'editeur, cliquez sur le bouton Commentaires dans l'en-tete (a cote du bouton « Envoyer »)
Le badge affiche le nombre de commentaires existants (par ex. : « 8 »)
L'editeur passe en mode visualisation avec les marqueurs visibles
Pour revenir au mode edition, cliquez a nouveau sur le bouton Commentaires

Restriction : Le mode commentaires n'est pas disponible sur les petits appareils mobiles (viewport < 768px). Il fonctionne sur les tablettes (iPad, Android) et les ordinateurs de bureau. Une infobulle sur le bouton desactive explique : « Utilisez un ordinateur de bureau pour gerer les commentaires ».

Disposition du mode commentaires

┌─────────────────────────────────────────────────────────────────┐
│  ← Retour         [💬 Commentaires 8]    [Envoyer]      │ En-tete │
├─────────────────────────────────────┬───────────────────────────┤
│                                     │ 💬 3 commentaires          │
│   Apercu du Markdown                │ ─────────────────────────│
│   (lecture seule)                   │ ◉ Tous ○ Ouverts ○ Resol.│
│                                     │ ─────────────────────────│
│        📍 Marqueur 1               │ [1] João · il y a 2h       │
│                                     │     Verifier cette section │
│        📍 Marqueur 2               │     « extrait du texte... »│
│                                     │     [Aller a]              │
│                                     │ ─────────────────────────│
│                                     │ [2] Maria · il y a 1j  ✅  │
│                                     │     Corrige                │
└─────────────────────────────────────┴───────────────────────────┘

Fonctionnalites du panneau de commentaires

Le panneau lateral droit offre :

Fonctionnalite	Description
Filtres	Tous / Ouverts / Resolus
Liste des commentaires	Tous les commentaires du document avec auteur, date et apercu du texte selectionne
Aller a	Fait defiler la visualisation jusqu'au marqueur correspondant
Ouvrir le fil	Cliquez sur le commentaire pour voir les reponses et interagir

Resoudre les commentaires

En mode commentaires, vous pouvez resoudre les discussions directement :

Cliquez sur un commentaire dans le panneau ou sur le marqueur dans le document
La fenetre modale du fil s'ouvre montrant le commentaire original et les reponses
Cliquez sur « Marquer comme resolu » pour indiquer que la question a ete traitee
Le marqueur passe de violet (ouvert) a vert (resolu)
Le commentaire peut etre filtre par l'onglet « Resolus »

Pour rouvrir un commentaire resolu, ouvrez le fil et cliquez sur « Rouvrir ».

Difference entre le visualiseur et l'editeur

Aspect	Visualiseur (fenetre de previsualisation)	Editeur (mode commentaires)
Creer des commentaires	Oui - Selectionnez du texte pour commenter	Non - Non disponible
Voir les commentaires	Oui - Marqueurs visibles	Oui - Marqueurs visibles
Resoudre/Repondre	Oui - Via la fenetre modale du fil	Oui - Via la fenetre modale du fil
Modifier le contenu	Non - Lecture seule	Oui - En mode edition

Flux recommande :

Visualiseur : Utilisez pour creer de nouveaux commentaires (selectionner du texte)
Editeur - Mode edition : Utilisez pour modifier le contenu markdown
Editeur - Mode commentaires : Utilisez pour examiner et resoudre les commentaires existants

Astuces utiles

Organisez avec des titres : Utilisez H1 pour le titre principal, H2 pour les sections et H3 pour les sous-sections. Cela facilite la lecture.
Sauvegardez regulierement : Bien qu'il y ait une sauvegarde automatique, vous pouvez cliquer sur « Terminer l'edition » a tout moment pour publier.
Avertissement de sortie : Si vous essayez de quitter la page avec des modifications non sauvegardees, le navigateur affichera un avertissement.
Images du projet : Preferez utiliser des images deja envoyees au projet. Elles sont stockees de maniere securisee et peuvent etre telechargees avec le document.
Liens de medias : Pour les videos et les audios, ajoutez d'abord le lien dans le dossier en utilisant « Ajouter un lien video » ou « Ajouter un lien audio », puis inserez-le dans le document.
Resolvez avant de publier : Avant de terminer l'edition, verifiez en mode commentaires s'il y a des discussions ouvertes qui doivent etre resolues ou auxquelles il faut repondre.