---
title: SiYuan
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, note-taking, siyuan, pkm, knowledge-base, block-editor, docker, privacy]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Note-Taking, https://github.com/siyuan-note/siyuan, https://b3log.org/siyuan]
---

# 🔗 SiYuan

> **Le PKM auto-hébergé orienté blocs et références bidirectionnelles**, pour celles et ceux qui veulent une base de connaissance personnelle dense, locale et très structurée.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Site web** | [b3log.org/siyuan](https://b3log.org/siyuan) |
| **GitHub** | [siyuan-note/siyuan](https://github.com/siyuan-note/siyuan) |
| **Licence** | AGPL-3.0 |
| **Langage** | TypeScript, Go |
| **Étoiles GitHub** | 44.3k ⭐ |
| **Dernière MAJ** | 2026-04-21 |
| **Catégorie** | [[cat-note-taking|Note-Taking]] |

## 📝 Description

**SiYuan** est un outil de **personal knowledge management** centré sur les **blocs**, les **références fines** et les **liens bidirectionnels**. Le projet se décrit comme un logiciel de knowledge management **privacy-first** et auto-hébergeable, avec édition **Markdown WYSIWYG**.

Il s'adresse surtout aux utilisateurs qui veulent construire une **base de connaissance personnelle riche**, avec une granularité plus fine qu'un carnet de notes traditionnel. On est plus proche d'un **PKM moderne** que d'un simple éditeur de texte : blocs référençables, attributs, exports multiples, flashcards, annotations, snippets et API publique.

Points notables :

- ✅ Références au niveau bloc
- ✅ Liens bidirectionnels et édition Markdown WYSIWYG
- ✅ Déploiement Docker officiellement documenté
- ✅ API publique et nombreuses fonctions avancées
- ⚠️ Certaines fonctionnalités sont réservées aux membres payants
- ⚠️ Le projet déconseille l'usage de solutions de sync tierces non prévues, sous peine de corruption

## 🚀 Installation

### Option recommandée : Docker Compose

Le dépôt fournit un exemple Compose clair.

```yaml
services:
  siyuan:
    image: b3log/siyuan
    container_name: siyuan
    command: ['--workspace=/siyuan/workspace/', '--accessAuthCode=change-me']
    ports:
      - "6806:6806"
    volumes:
      - ./siyuan-workspace:/siyuan/workspace
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
      - PUID=1000
      - PGID=1000
```

## ⚙️ Configuration Initiale

1. **Créer un workspace persistant** sur le volume monté.
2. **Définir un `accessAuthCode` fort** avant exposition réseau.
3. **Ajuster PUID/PGID** pour éviter les problèmes de permissions.
4. **Tester les sauvegardes** du workspace avant un usage intensif.
5. **Éviter les solutions de synchronisation tierces** non recommandées par le projet.
6. **Décider si les fonctions avancées** comme OCR, API ou IA sont nécessaires.

## 🔄 Alternatives

### Open Source
- [[app-trilium-notes]] — PKM hiérarchique avec arbre profond
- [[app-joplin]] — Plus classique et plus grand public
- [[app-affine]] — Plus collaboratif et plus visuel
- [[app-appflowy]] — Workspace plus large orienté équipes
- **Logseq** — PKM local-first proche en philosophie

### Propriétaires
- **Obsidian Sync + plugins**
- **Roam Research**
- **Notion**
- **Mem.ai**

## 🔐 Sécurité

- ✅ Le projet met en avant une approche **privacy-first**
- ✅ Le code d'accès de l'instance doit être défini dès le départ
- ⚠️ Une mauvaise stratégie de synchronisation peut corrompre les données
- ✅ Sauvegarder régulièrement le workspace et tester les restaurations
- ✅ Exposer l'instance derrière HTTPS si accessible à distance

## 📚 Ressources

- [Site officiel](https://b3log.org/siyuan)
- [GitHub siyuan-note/siyuan](https://github.com/siyuan-note/siyuan)
- [Releases / documentation de déploiement via README](https://github.com/siyuan-note/siyuan)

## Pages Liées

- [[cat-note-taking]] — Catégorie Note-Taking
- [[app-trilium-notes]] — Autre outil PKM avancé
- [[app-joplin]] — Notes plus classiques
- [[app-affine]] — Workspace plus collaboratif
