Catppuccin Obsidian Setup: A Vault You Can Read All Day
Petit Keycaps
Catppuccin Obsidian setup starts with two decisions: install the official community theme, then choose a light or dark base. Latte is the light option; Mocha is the default dark option. Frappé and Macchiato become available through the Style Settings plugin. You can have a useful setup before touching a line of CSS.
The more interesting work comes afterward. A theme can look excellent in a screenshot and still make your own notes awkward to scan. Use a real note with links, checkboxes, headings, and a long paragraph as your test page. That will tell you more than an empty vault ever will.
Install the official Catppuccin theme
- Open the vault you want to customize. Go to Settings → Appearance → Manage in the themes section.
- Search for Catppuccin. Choose the entry associated with the official Catppuccin Obsidian project, then install and enable it.
- Return to Appearance. Choose Light for Latte or Dark for the default Mocha appearance.
- Open your test note in both Live Preview and Reading view. Check links, highlighted text, and selected text before making further changes.
Obsidian may label parts of this screen differently between releases. The reliable starting point is its Appearance settings. Also check the theme name carefully: AnuPpuccin and other Catppuccin-inspired themes have their own controls, so instructions for those themes will not always apply here.
Choose the flavor before changing individual colors
Start with Latte if most of your day involves light browser pages, documents, and a bright room. Start with Mocha if you already work in dark applications. These are practical starting points, not rules about which theme is healthier or more productive.
| Flavor | How to select it | What to check in your notes |
|---|---|---|
| Latte | Appearance → light color scheme | Whether subtle highlights remain visible beside the pale page |
| Mocha | Appearance → dark color scheme; default dark flavor | Whether secondary text is easy to read at your usual brightness |
| Frappé | Dark scheme plus Style Settings | Whether its lighter dark background makes panels easier to distinguish |
| Macchiato | Dark scheme plus Style Settings | Whether it feels like a useful middle ground in your room |
For a wider comparison, our Catppuccin flavors guide explains the four palettes. In Obsidian, keep the same note and window size while comparing them. Otherwise you end up comparing layouts as much as colors.
Use Style Settings for dark flavors and accents
If you want Frappé, Macchiato, or more control over accents, install Style Settings by mgmeyers through Community plugins and enable it. Installing community plugins requires leaving Restricted mode. This is optional for a basic Latte or Mocha setup.
Open Style Settings and look for the Catppuccin controls. Set the dark flavor there, with Obsidian itself still in dark mode. Choose one accent if the full palette feels too busy. A quiet blue or mauve accent is a useful starting point when headings, links, and callouts already give the page plenty of structure.
Change one setting at a time and keep a short note of what you changed. If every heading, folder, and checkbox becomes an accent, nothing stands out. Reserve the strongest color for the things you need to find quickly: a link, an active item, or a small number of important callouts.
Make a long note comfortable to use
Begin with text size and line length. If your eyes keep losing the start of the next line, narrow the reading area before trying a different palette. If a dense reference note feels cramped, give the text more room rather than making every heading larger. Try the same changes on a laptop screen as well as your main monitor.
Next, check the parts of a note that are easy to overlook: an unchecked task, an inline code fragment, an external link, and text inside a callout. A beautiful heading color is not much help if selected text becomes hard to distinguish. Keep a small “theme test” note so you can repeat this check after updates.
Finally, consider how often you switch apps. Pairing Latte with a light browser and a light editor can make the workspace feel more consistent. If you use VS Code, our Catppuccin VS Code setup guide covers that separate installation.
When the theme does not look right
| Symptom | First thing to check |
|---|---|
| Latte does not appear | Set Obsidian's base scheme to Light. The dark-flavor selector does not switch the app into light mode. |
| Frappé or Macchiato is missing | Confirm Style Settings is installed and enabled, then inspect the Catppuccin dark-flavor controls. |
| One plugin panel has odd colors | Compare a normal note with that panel. Temporarily disable relevant CSS snippets to isolate an override. |
| Your vault differs from the preview | Compare fonts, plugins, and layout separately. A theme preview can include configuration beyond the theme itself. |
If a problem remains, record the Obsidian version, theme version, affected view, and the smallest example that reproduces it before opening a report in the official repository. That is far more useful than a screenshot of an entire vault with no explanation of what changed.
Finish the workspace without overdoing the palette
A light keyboard can carry the color scheme beyond the screen without requiring every object to be pastel. Our Catppuccin Light Keycap Set uses a pale base with colored accents. Treat it as a physical interpretation of the palette: plastic, monitor output, and room lighting will not produce identical colors.
Keep the setup once you can comfortably read, navigate, and select text in your usual notes. The best stopping point is the moment you stop adjusting the theme and start using the vault.