Django-Spellbook

Try the New Markdown Editor! Explore Themes

Version 0.1.17

Changed

Beautiful Documentation Out of the Box

Running python manage.py spellbook_md now gives you a gorgeous, professional documentation site automatically - no configuration needed!

What you get instantly:

  • Sidebar table of contents that's always visible

  • Full theme support - all 9 built-in themes work immediately

  • Responsive design - looks great on mobile and desktop

  • Metadata display - frontmatter data beautifully presented

Before: Raw HTML with no styling
Now: Production-ready documentation site

Want to customize? You still can! Set SPELLBOOK_MD_BASE_TEMPLATE in your settings to use your own template, or set it to None if you just want the raw HTML.

Fixed

Themes Now Work Everywhere

Fixed a bug where only metadata boxes changed colors when switching themes. Now everything responds to your theme:

  • Table of contents text and borders

  • Body text and headings

  • Code blocks and inline code

  • All UI elements

Before: Switching themes only changed metadata colors, rest stayed the same
Now: Entire page transforms with your chosen theme

Long Words No Longer Break Layout

Fixed annoying horizontal scrollbar that appeared when table of contents had long words with underscores (like really_long_function_name_with_underscores).

Before: Long words caused horizontal scrolling in sidebar
Now: Long words wrap gracefully, no scrollbar

Table of Contents Highlights Your Location

When you visit a page from a bookmark, search engine, or direct link, the table of contents now automatically expands and highlights your current location.

Before: TOC stayed collapsed when visiting from external links
Now: TOC opens to show exactly where you are

Smoother Page Loading

Removed the jarring "expanding" animation when pages first load. TOC now appears instantly in the correct state, while clicks still animate smoothly.

Before: Distracting flash of animation on every page load
Now: Clean, instant page loads with smooth interactions

â„šī¸

We're committed to continuous improvement and building the most powerful markdown processing toolkit for Django. If you have feedback or feature requests, please open an issue on GitHub.