https://github.com/catppuccin/mdbook
🎊 Soothing pastel theme for mdBook
https://github.com/catppuccin/mdbook
catppuccin hacktoberfest markdown mdbook mdbook-preprocessor mdbook-theme theme
Last synced: 2 months ago
JSON representation
🎊 Soothing pastel theme for mdBook
- Host: GitHub
- URL: https://github.com/catppuccin/mdbook
- Owner: catppuccin
- License: mit
- Created: 2022-07-24T03:50:29.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-07-09T13:37:13.000Z (3 months ago)
- Last Synced: 2025-07-25T20:06:50.967Z (3 months ago)
- Topics: catppuccin, hacktoberfest, markdown, mdbook, mdbook-preprocessor, mdbook-theme, theme
- Language: Handlebars
- Homepage: http://mdbook.catppuccin.com
- Size: 3.35 MB
- Stars: 200
- Watchers: 5
- Forks: 11
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Catppuccin for mdBook
## Previews
🌻 Latte
🪴 Frappé
🌺 Macchiato
🌿 Mocha
## Usage
> [!IMPORTANT]
> The `mdbook-catppuccin` rust package has been deprecated. For further information
> on why this decision was made, please refer to
> [catppuccin/mdBook#107](https://github.com/catppuccin/mdBook/issues/107)
>
> Please follow the instructions below to install the Catppuccin theme for mdBook.
1. Initialise your mdBook with the theme files:
```shell
mdbook init --theme
```
2. Enter the book directory and remove all theme files except `index.hbs`:
```shell
cd
# Remove all files except index.hbs
find ./theme -type f ! -name 'index.hbs' -delete
# Remove the left over empty directories
rm -d fonts css
```
3. Download the [catppuccin.css](https://github.com/catppuccin/mdBook/releases/latest/download/catppuccin.css)
file from the [latest GitHub release](https://github.com/catppuccin/mdBook/releases/latest) to the `theme`
directory.
See the [Supported Plugins](#supported-plugins) section below for integrations with other
mdBook plugins.
4. Update `additional-css` key within the `book.toml` as shown below
```diff
[output.html]
-additional-css = []
+additional-css = ["./theme/catppuccin.css"]
```
5. Edit the `index.hbs` file to include the Catppuccin flavors:
```diff
-
-
-
-
-
+
+
+
+
```
Additionally, you can use
[default-theme](https://rust-lang.github.io/mdBook/format/configuration/renderers.html?highlight=default-theme#html-renderer-options)
and
[preferred-dark-theme](https://rust-lang.github.io/mdBook/format/configuration/renderers.html?highlight=preferred-dark-theme#html-renderer-options)
keys for setting default light/dark mode themes in your `book.toml`.
E.g. To set the default theme to `latte` and default dark mode to `mocha`:
```diff
[output.html]
+ default-theme = "latte"
+ preferred-dark-theme = "mocha"
```
6. Build using `mdbook build` and enjoy your new Catppuccin flavors!
### Supported Plugins
This theme also generates CSS files to style elements added by other mdBook
plugins. We support the following list of plugins:
| Plugin | CSS File |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| [mdbook-admonish](https://github.com/tommilligan/mdbook-admonish) | [catppuccin-admonish.css](https://github.com/catppuccin/mdBook/releases/latest/download/catppuccin-admonish.css) |
| [mdbook-alerts](https://github.com/lambdalisue/rs-mdbook-alerts) | [catppuccin-alerts.css](https://github.com/catppuccin/mdBook/releases/latest/download/catppuccin-alerts.css) |
The CSS file(s) can be downloaded and added to the `additional-css` key shown
in step `4.` of the [Usage](#usage) section.
## Development
1. Clone the repository and navigate to the repository root.
```shell
git clone https://github.com/catppuccin/mdbook
cd mdbook
```
2. Generate the CSS files:
```shell
pnpm install
pnpm run build
```
## Acknowledgement
[mdbook-admonish](https://github.com/tommilligan/mdbook-admonish) for
inspiration on the `install` command for the now deprecated `mdbook-catppuccin`
binary.
## 💝 Thanks to
- [Hamothy](https://github.com/sgoudham)
- [winston](https://github.com/nekowinston)
Copyright © 2021-present Catppuccin Org
