https://github.com/typemill/typemill
Typemill is a flat-file CMS based on Markdown and designed for informational websites like documentation, manuals, and handbooks.
https://github.com/typemill/typemill
cms docs documentation documentation-tool ebooks epub-generation flat-file handbooks helpauthoring manuals markdown pdf-generation publication self-hosted technical-writing userguides websites
Last synced: 29 days ago
JSON representation
Typemill is a flat-file CMS based on Markdown and designed for informational websites like documentation, manuals, and handbooks.
- Host: GitHub
- URL: https://github.com/typemill/typemill
- Owner: typemill
- License: mit
- Created: 2017-04-12T21:01:11.000Z (about 8 years ago)
- Default Branch: v2.x
- Last Pushed: 2025-03-18T14:28:59.000Z (3 months ago)
- Last Synced: 2025-03-31T20:05:28.130Z (2 months ago)
- Topics: cms, docs, documentation, documentation-tool, ebooks, epub-generation, flat-file, handbooks, helpauthoring, manuals, markdown, pdf-generation, publication, self-hosted, technical-writing, userguides, websites
- Language: JavaScript
- Homepage: https://typemill.net
- Size: 22.6 MB
- Stars: 491
- Watchers: 12
- Forks: 58
- Open Issues: 61
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
- awesome-homelab - Typemill - file CMS based on Markdown and designed for informational websites like documentation, manuals, and handbooks. | (Apps / Writing)
- awesome - typemill/typemill - Typemill is a flat-file CMS based on Markdown and designed for informational websites like documentation, manuals, and handbooks. (JavaScript)
README
# Typemill
Typemill is an open-source flat-file CMS for creating websites and eBooks with markdown files. It’s commonly used for informational websites such as user manuals, documentation, knowledge bases, wikis, and handbooks.
Learn more at [typemill.net](https://typemill.net) or get started with the [starter guide](https://docs.typemill.net/getting-started).
## Key Features
* **Flat-file** – no database required.
* **Modern stack** – built with Slim PHP, Vue.js, and Tailwind CSS.
* **Lightweight** – only 2MB when gzipped.
* **Author-friendly** – visual block editor and raw markdown editor.
* **Developer-friendly** – Twig templates, Symfony event dispatcher, YAML definitions.
* **Flexible** – extend with plugins, themes, and custom eBook layouts.
* **Single Source Publishing** – convert content to PDF and ePUB with the eBook plugin.
## Requirements
To run Typemill, you need the following:
* Web server (Apache or Nginx).
* PHP 8.0 or higher.
* Standard PHP libraries like mod_rewrite, gd, mbstring, fileinfo, session, iconv, and more.
## Installation
Check installation guides for different setups at [docs.typemill.net](https://docs.typemill.net/getting-started/installation)
### Using ZIP File and FTP
1. Download and unpack the latest zip-version from the [Typemill Website](https://typemill.net).
2. Upload all files to your server.
3. Check the file-permissions (see below).
4. Visit your new website at `www.your-typemill-website.com/tm/setup`.
5. Create an admin user.
6. Log in and start writing.
### Using GitHub and Composer
Clone this repository:
```
git clone https://github.com/typemill/typemill.git
```
Run Composer to install the required libraries:
```
composer update
```
### Using Docker
Use the official image from [DockerHub](https://hub.docker.com/r/kixote/typemill) or read the description on [docs.typemill.net](https://docs.typemill.net/getting-started/installation/docker)
## Folder Permissions
Ensure that the following folders are writable:
* `/cache`
* `/content`
* `/data`
* `/media`
* `/settings`
## Security Issues
If you discover a potential security issue related to Typemill, please report it via email to [email protected], and we'll address it promptly.
## License
Typemill is an open-source project published under the MIT License. Plugins, themes, and services are published under MIT and commercial licenses.