Présentation

HedgeDoc est un éditeur de notes collaboratif en temps réel, hébergé au sein de l’unité, déployé et maintenu par le PIT. Il permet de rédiger à plusieurs, simultanément, des documents en Markdown : comptes-rendus de réunion, documentation technique, brouillons de publications, notes de séminaire... le tout depuis votre navigateur, sans rien installer.

L’adresse URL du service est : https://pad.cristal.fr. L’authentification repose sur le compte CRIStAL (SSO via Keycloak).

À quoi ça sert ?

Rédiger à plusieurs en temps réel

Vous créez une note, vous partagez le lien avec vos collègues, et tout le monde peut écrire en même temps. Chaque participant voit les modifications des autres en temps réel, avec un curseur coloré par personne. C’est l’équivalent de Google Docs, mais en Markdown, hébergé chez nous, et sans envoyer vos données chez Google.

Prendre des notes structurées en Markdown

Le Markdown est un format de texte léger et lisible qui permet de structurer rapidement un document avec des titres, des listes, du code, des tableaux, des formules mathématiques (LaTeX) et des diagrammes (Mermaid). Si vous êtes familier avec la syntaxe de README sur GitLab/GitHub, vous savez déjà utiliser HedgeDoc.

Garder une trace de vos réunions et séminaires

Plutôt que des notes éparses dans des fichiers Word ou des mails, HedgeDoc centralise vos comptes-rendus dans un endroit accessible à toute l’équipe. Chaque note a une URL permanente que vous pouvez référencer dans vos mails, vos wikis ou vos tickets.

Préparer des documents avant de les formaliser

HedgeDoc est idéal comme brouillon collaboratif avant de produire un document final (article, rapport, documentation). Vous rédigez le fond à plusieurs dans HedgeDoc, puis vous exportez en Markdown, PDF ou HTML pour la mise en forme définitive.

Qui est concerné ?

HedgeDoc est ouvert à tous les personnels du CRIStAL :

• Équipes de recherche : comptes-rendus de réunions d’équipe, notes de séminaire, rédaction collaborative de sections d’articles.
• Encadrants et doctorants : suivi de thèse, notes de réunions d’avancement, listes de tâches partagées.
• Services techniques et administratifs : documentation de procédures, prises de notes en réunion de service.
• Organisateurs d’événements : prise de notes collective pendant un workshop, un hackathon ou une journée d’étude.

Comment y accéder ?

Créer une note

1. Rendez-vous sur https://pad.cristal.fr.
2. Connectez-vous avec votre compte CRIStAL (bouton "Sign in" -> puis "Sign in via Keycloak").
3. Cliquez sur "New note" — vous obtenez une note vierge avec une URL unique.

Partagez l’URL avec vos collègues. Ils pourront éditer la note en se connectant à leur tour.

L’interface

L’écran se divise en deux parties :

• À gauche : l’éditeur Markdown (vous tapez ici).
• À droite : le rendu en temps réel (le résultat mis en forme).

Vous pouvez basculer entre trois modes d’affichage : éditeur seul, rendu seul, ou les deux côte à côte.

Gestion des permissions

Chaque note dispose de paramètres de partage que vous pouvez ajuster :

• Freely : tout le monde avec le lien peut lire et écrire (idéal pour une prise de notes en réunion).
• Editable : les utilisateurs connectés peuvent éditer, les autres ne voient que le rendu.
• Locked : seul le propriétaire peut éditer, les autres lisent.
• Private : accessible uniquement par le propriétaire.

Exporter vos notes

HedgeDoc permet d’exporter vos notes dans plusieurs formats :

• Markdown (.md) : pour intégrer dans un dépôt Git, un wiki ou un autre outil.
• HTML : pour publier sur un site web ou un intranet.
• PDF : via la fonction d’impression du navigateur (Ctrl+P depuis le mode rendu).

Bonnes pratiques

Nommez vos notes avec un titre explicite dès la création. La première ligne # Mon titre sert de titre dans la liste de vos notes.

Ajoutez la date et les participants en tête de vos comptes-rendus de réunion. Ça facilite la recherche ensuite.

Utilisez les tags (via le YAML front matter tags : [réunion, equipe-machin]) pour organiser vos notes.

Exportez et archivez les notes importantes. HedgeDoc est un outil de rédaction collaborative, pas un système d’archivage long terme.

Ne stockez pas de données sensibles (mots de passe, clés, données personnelles) dans les notes, même privées.