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.