A clean, modern MkDocs theme built with TailwindCSS. Features a Doom One dark mode, full-text search, responsive layout, and BEM-structured CSS.

• TailwindCSS via Play CDN with custom color palette
• Doom One dark mode — toggle with button, respects system preference, persisted in localStorage
• Full-text search — lunr.js powered, Ctrl+K / Cmd+K shortcut, keyboard navigation, highlighted snippets
• Responsive — collapsible sidebar on mobile, three-column layout on desktop (sidebar / content / table of contents)
• Table of contents — right sidebar with scroll-spy highlighting
• Prev / Next navigation between pages
• Syntax highlighting — highlight.js with GitHub Light / Atom One Dark themes
• Inter + JetBrains Mono fonts
• BEM-structured CSS — all styles use Block Element Modifier naming, no inline utility classes

pip install mkdocs-cwd

Set the theme in your mkdocs.yml:

site_name: My Docs
theme:
  name: cwd

plugins:
  - search

The search plugin is required for the search modal to work.

Dark mode uses the Doom One color palette from Doom Emacs. It toggles via:

• The moon/sun button in the header
• System preference (prefers-color-scheme: dark)
• Persisted in localStorage across sessions

Override any template by creating a custom_dir alongside the theme:

theme:
  name: cwd
  custom_dir: overrides/

Then place partial templates in overrides/ to extend or replace blocks.

git clone https://github.com/catwatchdog/mkdocs-cwd.git
cd mkdocs-cwd
pip install -e .

MIT