Aller au contenu principal

Outline

Overview​

Outline, c'est la plateforme de wiki collaborative qui pense que la documentation doit être belle, rapide et intuitive. Contrairement aux wikis classiques lourds et complexes, Outline offre une interface moderne style Notion avec une navigation fluide, du markdown avancé, et une organisation par collections. Si tu veux un wiki qui donne envie d'écrire de la doc, c'est parfait.

Outline mise sur la simplicité et l'efficacité : éditeur WYSIWYG avec markdown, recherche ultra-rapide, permissions granulaires par collection, commentaires et révisions, intégrations Slack/Discord. Interface web uniquement, pas d'applications natives, mais optimisé mobile.

Outline se distingue par son interface moderne (inspirée de Notion mais plus simple), sa vitesse exceptionnelle (recherche et navigation ultra-rapides), et son approche équilibrée (puissant mais pas overwhelming comme Notion).

Informations essentielles​

PropriétéValeur
Site officielhttps://www.getoutline.com/
Repositoryhttps://github.com/outline/outline
LicenceBSD 3-Clause
DéveloppeurOutline
LangageTypeScript/React (frontend), Node.js (backend)
Base de donnéesPostgreSQL

Fonctionnalités principales​

Interface moderne​

  • Éditeur WYSIWYG avec support markdown complet
  • Interface style Notion mais plus épurée
  • Navigation par arborescence et collections
  • Mode sombre/clair avec switch automatique
  • Responsive design optimisé mobile

Organisation flexible​

  • Collections : organisation par équipe/projet/thème
  • Groupes : partage de collections avec permissions
  • Sous-pages illimitées avec hiérarchie
  • Tags et catégories pour classification
  • Templates pour standardiser le contenu

Collaboration avancée​

  • Édition collaborative en temps réel
  • Système de commentaires par paragraphe
  • Historique des révisions avec diff visuel
  • Notifications push et email configurables
  • Mentions d'utilisateurs avec notifications

Recherche et découverte​

  • Recherche full-text ultra-rapide
  • Recherche par tags, auteur, collection
  • Navigation par clavier (raccourcis Vim-like)
  • Liens bidirectionnels entre documents
  • Suggestions de contenu connexe

Cas d'usage​

  • Documentation équipe : Base de connaissances centralisée moderne
  • Onboarding : Guides et processus pour nouveaux arrivants
  • Runbooks : Procédures opérationnelles avec recherche rapide
  • Meeting notes : Comptes-rendus partagés avec historique
  • Knowledge base : Wiki entreprise avec interface moderne

Installation​

Via Docker Compose (self-hosted)​

version: '3.2'
services:
  outline:
    image: outlinewiki/outline:latest
    env_file: ./docker.env
    ports:
      - "3000:3000"
    volumes:
      - outline-data:/var/lib/outline/data
    depends_on:
      - postgres
      - redis

  postgres:
    image: postgres:13
    environment:
      POSTGRES_USER: outline
      POSTGRES_PASSWORD: pass
      POSTGRES_DB: outline
    volumes:
      - postgres-data:/var/lib/postgresql/data

  redis:
    image: redis:6
    volumes:
      - redis-data:/data

volumes:
  outline-data:
  postgres-data:
  redis-data:

Configuration environnement​

# docker.env
NODE_ENV=production
SECRET_KEY=generate-a-secret-key-here
UTILS_SECRET=generate-another-secret-key

DATABASE_URL=postgres://outline:pass@postgres:5432/outline
REDIS_URL=redis://redis:6379

URL=https://outline.yourcompany.com
PORT=3000

# SSO Authentication (exemple Slack)
SLACK_CLIENT_ID=your-slack-client-id
SLACK_CLIENT_SECRET=your-slack-client-secret

# File uploads (exemple AWS S3)
AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-key
AWS_REGION=us-east-1
AWS_S3_UPLOAD_BUCKET_NAME=outline-uploads

Via cloud (SaaS)​

# Simple inscription sur getoutline.com
# Plan gratuit : 10 utilisateurs
# Plan team : $8/utilisateur/mois
# Plan business : $16/utilisateur/mois

Utilisation basique​

Création d'une collection​

  1. Nouvelle collection : Click "New collection"
  2. Configuration : Nom, description, icon, couleur
  3. Permissions : Définir qui peut voir/éditer
  4. Templates : Créer des modèles de documents

Écriture de contenu​

# Titre de document

## Section avec formatage
Ceci est du **texte gras** et *italique*.

### Code blocks
```bash
# Commande exemple
kubectl get pods

Callouts​

ℹ️ Info : Ceci est une information importante

Tables​

Colonne 1Colonne 2
Data 1Data 2

Liens et références​

Lien vers documentation @mention d'un utilisateur


### Permissions et partage
```bash
# Niveaux de permissions par collection:
# - View : Lecture seule
# - Comment : Lecture + commentaires  
# - Edit : Écriture complète
# - Admin : Gestion collection

# Partage public:
# - Lien public avec mot de passe optionnel
# - Embed iframe pour intégration externe

API et intégrations​

// API REST pour intégrations custom
const response = await fetch('/api/documents', {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

// Webhooks pour notifications externes
// POST vers votre endpoint sur changements

Avantages​

  • ✅ Interface moderne : UX excellente inspirée de Notion mais plus simple, plaisir d'utilisation
  • ✅ Performance : recherche et navigation ultra-rapides, très fluide
  • ✅ Self-hosted : contrôle total sur tes données, pas de vendor lock-in
  • ✅ Collaboration native : édition temps réel, commentaires, pas de conflits
  • ✅ Open source : code disponible, communauté active, évolutions transparentes

Limitations​

  • Pas d'applications natives (desktop/mobile) : mais PWA fonctionne bien
  • Fonctionnalités avancées moins riches que Notion : mais c'est volontaire pour rester simple
  • Base d'utilisateurs plus petite que les solutions établies : mais croissante

Alternatives​

  • Notion : Plus de fonctionnalités mais plus complexe
  • Obsidian : Centré sur les liens bidirectionnels
  • GitBook : Spécialisé documentation technique
  • Slab : Concurrent direct avec approche similaire

Ressources​