SiYuan est un logiciel de prise de notes qui organise le contenu en blocs. Vous pouvez écrire comme dans un éditeur classique, puis relier un paragraphe précis, retrouver ses références, ajouter des champs structurés ou le réutiliser ailleurs sans recopier toute la page.
Cette approche place SiYuan entre le carnet de notes, le wiki personnel et la base de connaissances. Le logiciel fonctionne d’abord avec un workspace local, propose un éditeur WYSIWYG compatible avec Markdown et rassemble dans la même interface les liens bidirectionnels, les bases de données, la recherche, les flashcards et les modèles.
Dans ce guide, vous allez découvrir les fonctionnalités essentielles de SiYuan, son organisation, son stockage, ses modes d’installation et ses limites. Une courte partie montrera ensuite comment l’associer à Hermes Agent si vous voulez aller plus loin.
Découvrir SiYuan en vidéo
Cette vidéo de la chaîne FEU montre pourquoi j’ai remplacé Notion par SiYuan, puis parcourt l’interface, les pages, les références, les bases de données, les extensions, l’API et l’intégration facultative avec Hermes Agent.
Qu’est-ce que SiYuan ?
SiYuan se présente comme un système de gestion des connaissances personnelles orienté confidentialité. Son éditeur affiche directement le résultat mis en forme, tout en acceptant la syntaxe Markdown pour écrire rapidement des titres, listes, citations ou blocs de code.
La différence principale se trouve sous l’éditeur. Dans SiYuan, un paragraphe, un titre, une liste ou une image possède son propre identifiant. Cette unité s’appelle un bloc. Une page reste utile pour lire et organiser un sujet, mais le bloc permet de viser une information précise.
Vous pouvez ainsi référencer une décision sans copier tout son document, afficher les pages qui l’utilisent, lui ajouter des attributs et la retrouver avec une recherche plus structurée.
Les données sont enregistrées dans le workspace choisi sur votre machine. Les documents utilisent des fichiers .sy au format JSON et les pièces jointes sont stockées dans des dossiers dédiés. SiYuan sait importer, éditer et exporter du Markdown, mais son stockage natif n’est pas un simple dossier de fichiers .md.
La plupart des fonctions locales sont gratuites, y compris pour un usage commercial. La synchronisation officielle, la connexion à certains stockages distants et plusieurs fonctions PRO dépendent d’une offre payante.
Les fonctionnalités essentielles de SiYuan
SiYuan propose beaucoup d’options, mais quelques fonctions suffisent pour comprendre son intérêt.
| Fonction | Usage concret |
|---|---|
| Éditeur par blocs | Écrire des notes, listes, tableaux, formules et contenus riches |
| Références de blocs | Citer une information précise dans un autre document |
| Liens bidirectionnels | Relier deux sujets et voir les liens entrants |
| Recherche plein texte | Retrouver un mot ou une expression dans les notebooks |
| Bases de données | Ajouter des champs, filtrer et afficher des éléments en tableau |
| Modèles | Réutiliser une structure de note ou de compte rendu |
| Flashcards | Transformer certains blocs en cartes de révision |
| Export | Produire du Markdown avec ses ressources, du PDF, du Word ou du HTML selon le mode utilisé |
| Multi-onglets et écran partagé | Consulter plusieurs documents pendant l’écriture |
| API locale | Automatiser la lecture ou la modification de contenus |
Un éditeur WYSIWYG organisé par blocs
L’éditeur de SiYuan reste lisible pendant l’écriture. Vous n’avez pas besoin de travailler dans un fichier brut puis d’ouvrir un aperçu séparé. La syntaxe Markdown sert surtout de raccourci pour créer la mise en forme.
Chaque bloc possède un menu et peut être déplacé, replié, copié ou affiché seul grâce au zoom de bloc. Cette granularité devient pratique dans les documents longs : vous pouvez isoler une section, déplacer une liste complète ou référencer un seul paragraphe.
SiYuan prend aussi en charge les formules mathématiques, diagrammes, organigrammes, graphiques de Gantt, partitions et autres contenus techniques. Ces fonctions sont disponibles sans transformer chaque note en document complexe.
Références, backlinks et liens bidirectionnels
Un lien classique conduit vers une page. Une référence de bloc conduit vers l’information exacte que vous avez choisie. Si vous modifiez le bloc source, la référence continue de pointer vers cette version actualisée.
Les backlinks montrent les documents qui renvoient vers la note ou le bloc courant. Les mentions permettent également de repérer un sujet cité sans lien explicite. Vous obtenez ainsi deux niveaux de navigation : l’arborescence visible des documents et le réseau formé par leurs relations.
Le graphe global ou local aide à explorer ce réseau. Il reste un outil de découverte, pas une obligation pour organiser le workspace. Une recherche claire et des titres compréhensibles sont souvent plus utiles qu’un graphe spectaculaire.
Bases de données et attributs
Les bases de données donnent une vue structurée à des informations qui restent des blocs SiYuan. Vous pouvez afficher une liste de projets, de livres, de contacts ou de contenus sous forme de tableau, puis ajouter des propriétés et des filtres.
Les attributs personnalisés servent à enrichir un bloc sans alourdir son texte. Ils peuvent stocker un statut, une catégorie, une priorité ou un identifiant utilisé dans une requête.
Commencez avec peu de champs. Une base de données n’apporte rien si vous passez plus de temps à renseigner ses propriétés qu’à utiliser les informations qu’elle contient.
Recherche, modèles et flashcards
La recherche plein texte couvre les notebooks et permet de retrouver rapidement un terme. Pour des besoins plus avancés, SiYuan peut aussi interroger les blocs avec SQL et afficher le résultat dans un document.
Les modèles accélèrent les notes répétitives : compte rendu, fiche de lecture, suivi de contenu ou journal quotidien. Les snippets JavaScript et CSS permettent d’aller plus loin, mais ils ne sont pas nécessaires pour commencer.
La répétition espacée transforme des blocs sélectionnés en flashcards. Vous pouvez donc prendre une note, puis réutiliser une définition, une formule ou une question comme carte de révision sans maintenir une seconde copie dans une autre application.
Comment prendre en main SiYuan
L’application de bureau est le meilleur point de départ. Elle permet de tester toutes les fonctions locales sans installer de serveur ni concevoir immédiatement une architecture complète.
- Installez SiYuan sur Windows, macOS ou Linux.
- Choisissez le dossier du workspace et incluez-le dans votre stratégie de sauvegarde.
- Créez un notebook pour votre premier usage réel.
- Ajoutez un document et écrivez quelques paragraphes, listes et titres.
- Créez une référence de bloc depuis une deuxième page.
- Testez les backlinks et la recherche avant d’ajouter des plugins ou des bases de données.
- Exportez le document pour comprendre ce que vous pourrez récupérer hors de SiYuan.
L’organisation repose sur trois niveaux simples :
| Niveau | Rôle |
|---|---|
| Workspace | Ensemble des données et réglages de votre installation |
| Notebook | Grand espace de classement pour séparer des usages |
| Document et blocs | Contenu lisible et unités référençables |
Évitez de créer un notebook pour chaque petit thème. Une arborescence courte, de bons titres et quelques liens suffisent généralement au début.
Organiser ses notes sans construire une usine à gaz
Vous pouvez utiliser SiYuan comme carnet de travail sans adopter une méthode complète de gestion des connaissances. Une structure minimale suffit :
Inbox
Projets
Références
Archives- Inbox reçoit les informations qui doivent encore être triées.
- Projets regroupe les documents liés à un résultat en cours.
- Références conserve les procédures, définitions et informations réutilisables.
- Archives garde ce qui n’est plus actif sans le supprimer.
Utilisez les documents pour la lecture, les blocs pour les informations précises et les bases de données lorsque plusieurs éléments partagent réellement les mêmes propriétés.
Trois habitudes évitent la majorité des doublons : rechercher avant de créer, référencer le bloc existant au lieu de le copier et donner un titre explicite au document source.
Stockage, synchronisation et sauvegarde
Le caractère local de SiYuan signifie que le workspace peut rester sur votre appareil. Cela ne garantit pas que toutes les données restent toujours hors ligne : la synchronisation cloud, l’IA via l’API OpenAI ou un serveur distant changent les flux utilisés.
N’utilisez pas Dropbox, Google Drive ou OneDrive pour synchroniser directement un workspace actif. La documentation de SiYuan déconseille les disques de synchronisation tiers génériques en raison du risque de corruption. Les mécanismes pris en charge par SiYuan suivent un autre fonctionnement.
Un export Markdown produit une version lisible d’un document, mais ce n’est pas une sauvegarde complète. Une vraie stratégie doit protéger les données du workspace, les pièces jointes et les réglages nécessaires, puis tester une restauration.
Avant d’accumuler des informations importantes :
- sauvegardez le workspace sur un second support ;
- définissez une rétention de plusieurs versions ;
- ouvrez un export avec un autre logiciel ;
- restaurez un échantillon dans un environnement séparé.
Desktop, mobile, Docker et API : quel mode choisir ?
SiYuan existe sur ordinateur et sur mobile. Les applications desktop offrent le chemin le plus simple pour travailler localement. Les applications Android, iOS et HarmonyOS facilitent la consultation ou la capture en mobilité selon les fonctions et services activés.
Docker sert surtout à ouvrir SiYuan dans un navigateur depuis une machine qui reste allumée. Ce mode demande un volume persistant, des permissions correctes, une authentification et une exposition réseau maîtrisée. Il comporte aussi des limites : les applications desktop ou mobile ne se connectent pas au conteneur comme à une application classique, et certains imports ou exports ne sont pas disponibles.
L’API locale est une fonction avancée. Elle peut lister les notebooks, créer ou modifier des blocs, lancer des requêtes SQL et exporter un document. Le code de verrouillage de l’interface et le jeton API sont deux secrets distincts. Aucun des deux ne doit être placé dans une note ou un fichier public.
Pour un premier usage, choisissez donc l’application de bureau. Passez à Docker ou à l’API seulement lorsqu’un besoin concret justifie leur maintenance.
Tableau comparatif simple : SiYuan ou Obsidian ?
En pratique, le choix dépend surtout de votre façon de travailler : préférez-vous un outil tout-en-un organisé par blocs, ou un dossier de fichiers Markdown que vous pouvez ouvrir directement ailleurs ?
| Besoin concret | SiYuan | Obsidian |
|---|---|---|
| Prendre des notes | Éditeur riche avec beaucoup de fonctions déjà intégrées | Éditeur simple que vous complétez selon vos besoins |
| Organiser beaucoup d’informations | Documents découpés en blocs précis | Notes rangées en fichiers et dossiers |
| Réutiliser un paragraphe précis | Référence directe vers le bloc | Lien surtout pensé pour la note entière |
| Suivre des projets ou des listes | Bases de données intégrées | Propriétés, Bases et plugins selon le besoin |
| Garder des fichiers Markdown | Export nécessaire pour obtenir des fichiers .md standards | Chaque note est directement un fichier .md |
| Synchroniser ses notes | Synchronisation officielle selon l’offre choisie | Obsidian Sync ou autre méthode adaptée au vault |
| Ajouter des fonctions | Marketplace et personnalisation CSS ou JavaScript | Écosystème de plugins communautaires plus vaste |
| Meilleur choix si… | Vous voulez un outil tout-en-un centré sur les blocs | Vous voulez des fichiers Markdown simples et très portables |
Prenez SiYuan si vous voulez structurer finement vos informations sans assembler plusieurs extensions. Prenez Obsidian si votre priorité est de garder des fichiers Markdown faciles à déplacer. Si vous hésitez, créez dix notes dans chaque logiciel, reliez-les, puis testez l’export et la synchronisation.
Petite extension : utiliser SiYuan comme second cerveau avec Hermes Agent
Vous n’avez pas besoin de Hermes Agent pour utiliser SiYuan. Le logiciel fonctionne seul pour écrire, relier, chercher et organiser vos notes.
Si vous voulez ensuite transformer cette base en second cerveau exploitable par un agent, Hermes peut rechercher le sujet utile, exporter le document pertinent et agir avec ce contexte limité. Une correction durable peut enfin être réécrite dans SiYuan puis relue pour vérifier le résultat.
Le principe tient en trois étapes :
- chercher dans SiYuan avant de charger un long contexte ;
- transmettre à Hermes uniquement le document nécessaire ;
- vérifier toute écriture en relisant le document cible.
Cette intégration reste personnalisée : elle repose sur un Skill et un helper configurés pour votre instance. Si vous découvrez l’agent, commencez par le guide de Hermes Agent, puis consultez le guide des Agent Skills.
Les limites de SiYuan à connaître
Le stockage natif n’est pas un dossier Markdown
SiYuan importe et exporte Markdown, mais ses documents de notebook utilisent des fichiers .sy en JSON. Testez une migration sur un échantillon avant de déplacer toute votre documentation.
La richesse de l’interface demande un temps d’apprentissage
Blocs, attributs, bases de données, SQL, graphes, modèles, flashcards et extensions offrent beaucoup de possibilités. Activez-les progressivement pour ne pas transformer la prise de notes en administration permanente.
La synchronisation complète n’est pas entièrement gratuite
Le fonctionnement local couvre la majorité des usages de base. La synchronisation officielle et plusieurs fonctions distantes ou PRO dépendent cependant d’une offre payante.
Docker ajoute des responsabilités
Un conteneur ne rend pas automatiquement SiYuan privé ou sauvegardé. Vous devez gérer le volume, les permissions, l’accès réseau, les mises à jour et la restauration.
Par où commencer aujourd’hui
Pour tester SiYuan sans perdre une journée dans les réglages :
- installez l’application de bureau ;
- créez un seul notebook pour un usage réel ;
- ajoutez trois documents et quelques blocs ;
- reliez deux informations avec une référence de bloc ;
- testez la recherche et les backlinks ;
- créez une petite base de données seulement si un tableau vous serait utile ;
- exportez un document ;
- sauvegardez puis restaurez un échantillon.
Après une semaine, gardez les fonctions qui vous ont réellement aidé. Les autres pourront attendre.
Questions fréquentes sur SiYuan
À quoi sert SiYuan ?
SiYuan est-il gratuit ?
SiYuan utilise-t-il Markdown ?
.sy en JSON, et non sur un dossier de notes .md.
