---
title: Typemill
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, books, cms, markdown, publisher, documentation, flat-file, php, ebook]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Books, https://github.com/typemill/typemill]
---

# 📘 Typemill

> **Le CMS flat-file Markdown pour publishers, auteurs et créateurs de documentation** — Léger (2 Mo), extensible, et capable de produire PDF et EPUB à partir du même contenu.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Site web** | [typemill.net](https://typemill.net/) |
| **GitHub** | [typemill/typemill](https://github.com/typemill/typemill) |
| **Licence** | MIT (plugins / thèmes peuvent être commerciaux) |
| **Langage** | PHP (37%), JavaScript (52,8%) |
| **Étoiles GitHub** | 597 ⭐ |
| **Dernière MAJ** | 2026-05-27 |
| **Catégorie** | [[cat-books|Books]] |

## 📝 Description

**Typemill** est un **CMS flat-file** basé sur **Markdown**, conçu pour les **sites éditoriaux** : manuels utilisateur, documentation technique, knowledge bases, wikis, handbooks, **livres numériques**. Pas de base de données : tout est stocké en fichiers Markdown dans `content/`, ce qui rend les sauvegardes triviales (un `tar` du dossier) et la versionnative Git-friendly.

La promesse « **Single Source Publishing** » est centrale : vous écrivez votre contenu une fois en Markdown, et Typemill peut publier à la fois un **site web responsive** (thème Cyanine par défaut, Twig + Tailwind) et un **eBook EPUB/PDF** via le plugin eBook officiel. C'est l'outil idéal pour un **auteur indépendant**, une **petite maison d'édition** ou une équipe qui veut **documenter et publier** sans jongler entre deux chaînes d'outils.

L'**éditeur visuel par blocs** est accessible aux non-techniciens, mais l'éditeur Markdown brut reste disponible pour les développeurs. L'architecture **Slim PHP + Vue.js + Tailwind** est moderne, et l'écosystème de **plugins / thèmes** (souvent MIT, parfois commerciaux) couvre la plupart des besoins : newsletter, formulaires, multilingue, etc. La dernière release (V2.23.1, mai 2026) renforce la bibliothèque de l'éditeur et l'intégration OpenCode + « Ask The Docs ».

## 🚀 Installation

### Option 1 : Docker Compose (recommandé)

```yaml
# docker-compose.yml
services:
  typemill:
    image: kixote/typemill:latest
    container_name: typemill
    environment:
      - TZ=Europe/Paris
    volumes:
      - ./content:/var/www/html/content
      - ./cache:/var/www/html/cache
      - ./data:/var/www/html/data
      - ./media:/var/www/html/media
      - ./settings:/var/www/html/settings
    ports:
      - 8080:80
    restart: unless-stopped
```

Premier démarrage : `http://localhost:8080/tm/setup`, créer le compte admin.

### Option 2 : Installation manuelle (Apache / Nginx + PHP 8.1+)

```bash
git clone https://github.com/typemill/typemill.git
cd typemill
composer update
```

Puis pointer un vhost Apache / Nginx sur le dossier, et visiter `/tm/setup` pour finaliser.

## ⚙️ Configuration

1. **Permissions** : `cache/`, `content/`, `data/`, `media/`, `settings/` doivent être accessibles en écriture par le serveur web.
2. **Plugins** : activez eBook (PDF/EPUB), newsletter, multilingue selon vos besoins.
3. **Thèmes** : Cyanine est le défaut ; alternatives disponibles sur le site officiel.
4. **HTTPS** : obligatoire en cas d'éditeur exposé (Let'Encrypt + reverse proxy).
5. **Backups** : un simple `tar` du dossier Typemill suffit (flat-file !).
6. **OpenCode + Ask The Docs** : assistant IA intégré pour la rédaction (V2.23+).

## 🔄 Alternatives

### Open Source
- [[app-bookstack]] — Wiki/documentation, plus orienté équipe
- [[app-dokuwiki]] — Wiki PHP historique, sans Markdown-first
- [[app-jekyll]] — Générateur de site statique, plus brut
- [[app-hugo]] — Générateur Go ultra-rapide
- [[app-mkdocs]] — Documentation technique, idéal pour les devs

### Propriétaires
- **WordPress + plugins publisher**
- **Ghost** (CMS oriented publishing)
- **Wix / Squarespace**
- **Notion + Super.so**

## 🔐 Sécurité

- ✅ CMS **flat-file** : pas de base de données à protéger
- ✅ Mises à jour régulières (PHP 8.1+, dépendances à jour)
- ⚠️ Signalez les failles à **security@typemill.net** (canal dédié)
- ⚠️ Limitez l'accès à `/tm/setup` après l'installation
- ⚠️ HTTPS obligatoire pour protéger l'éditeur
- ⚠️ Sauvegardez régulièrement `content/` et `settings/` (vos contenus et votre config)

## 📚 Ressources

- [selfh.st — Books](https://selfh.st/apps/?tag=Books)
- [Site officiel](https://typemill.net/)
- [GitHub typemill/typemill](https://github.com/typemill/typemill)
- [Documentation](https://docs.typemill.net/)
- [Docker Hub — kixote/typemill](https://hub.docker.com/r/kixote/typemill)

## Pages Liées

- [[cat-books]] — Vue d'ensemble de la catégorie Books
- [[app-bookstack]] — Wiki/documentation, plus orienté équipe
- [[app-jekyll]] — Générateur de site statique
- [[app-hugo]] — Générateur Go rapide
- [[recettes-docker-compose]] — Templates Docker
