docmd v0.2.0 🚀 (Major Release)

[mgks]

✨ Features and Improvements

• Introducing New Custom Containers: Tabs and Buttons
• New Configs: sidebar{}, positionMode, autoTitleFromH1 and sponsor{}
• New Theme: Retro - Inspired by 1980s-90s computing aesthetics; includes neon colors, terminal styling etc.

Advanced Nested Container System

• Complete rewrite of the container parsing system for robust nesting support
• Seamless nesting - Any container can now be nested inside any other container
• Proper depth tracking - Handles multiple levels of nesting correctly
• Future-ready architecture - Easy to extend with new container types

Enhanced Container Support

• Tabs within Steps - No more list breaking when tabs are nested in ordered lists
• Cards within Tabs - Rich content organization with nested cards
• Callouts within Cards - Informational content within structured cards
• Buttons within Any Container - Action buttons work in any context
• Multiple Container Nesting - Support for complex nested structures up to 7+ levels

🔧 Technical Improvements

• Robust Parsing Engine
• Advanced container rule with proper nesting detection
• Enhanced tabs rule with nested content support
• Context-aware processing - Maintains list continuity and structure
• Recursive content processing - Handles nested markdown within containers

Code Quality

• Removed legacy safeContainer system - Replaced with modern nested container architecture
• Improved error handling - Better edge case management
• Cleaner code structure - More maintainable and extensible
• Performance optimizations - Efficient parsing and rendering

🐞 Bug Fixes

Critical Fixes

• Fixed @index.md HTML rendering - noStyle: true frontmatter now works correctly
• Resolved tabs container strict positioning - Flexible whitespace handling around ::: tabs
• Fixed code block processing - ::: sequences no longer render as emphasis in code blocks
• Eliminated list breaking - Ordered lists maintain structure with nested containers
• Codeblock content escape - HTML content inside code blocks are now properly escaped and displayed as literal text

Container-Specific Fixes

• Steps container - Now properly handles nested tabs without breaking list numbering
• Tabs container - Improved content parsing and nested container support
• Callout container - Better parameter handling and nested content support
• Button container - Enhanced color support and nested placement
• Steps not aligning content correctly
• Only steps' title needs to be put into quote > symbol, no more need for dot or number
• Menu bar not auto scrolling to active link

🎨 User Experience

• Enhanced Flexibility
• No more strict positioning rules - Containers work with flexible whitespace
• Intuitive nesting - Natural container combinations work as expected
• Better documentation - Clear examples of nested container usage
• Consistent behavior - All containers follow the same nesting patterns
• Divider --- default style improved
• Implementation of autoTitleFromH1 as suggested in issues (Feature Request: Automatic Frontmatter Title Generation using first H1 tag #1)
• Tabs container support added as suggested in discussions (Support for Tabs #2)

🚀 Future-Ready Architecture

• Extensible Design
• Modular container system - Easy to add new container types
• Standardized renderer pattern - Consistent implementation for new containers
• Plugin-friendly structure - Ready for community container extensions
• Backward compatibility - Existing container usage remains unchanged

❤️ Support the Project – Buy me a coffee ☕

---

This discussion was created from the release docmd v0.2.0 🚀 (Major Release).