Container Engine & AI Assistant Improvements
✨ Standardised containers, native Mermaid and tooltips, smarter AI Assistant navigation, and key parser, SPA, and template fixes in docmd 0.9.1.
Highlights
docmd v0.9.1 modernises the container engine with a standardised syntax, introduces native Mermaid diagrams and tooltips, improves the AI Assistant's documentation navigation and search, and fixes several rendering and SPA navigation issues.
No breaking changes. Existing container syntax remains supported for backward compatibility.
Container Engine
- Standardised explicit closing tags such as
::: tabs...::: /tabsacross structural containers. - Added named sub-containers for
tabs,steps, andchangelog. - Added explicit key-value attributes such as
title:"...",align:center, andzoom:true. - Added trailing
# commentsto container headers. - Improved self-closing and inline containers such as
button,tag, andembed. - Added the new
::: tiptooltip container. - Legacy container syntax remains fully supported.
Mermaid
Added a native ::: mermaid container with built-in themes, alignment, and pan/zoom controls.
Mermaid remains compatible with standard fenced code blocks (```mermaid), and the feature is automatically disabled when the Mermaid plugin is not enabled.
AI Assistant
- Added
get_site_structurefor inspecting versions, locales, projects, and page navigation. - Assistant now detects whether keyword or semantic search is available.
- Improved search queries for more precise results across both keyword and semantic search.
Fixes
- Fixed blank lines inside HTML blocks in
noStylepages and Markdown files (#187). - Fixed zero-config homepage links being incorrectly converted to
#during SPA navigation (#196). - Fixed announcement banners not rendering correctly in the Summer template.
Documentation
Updated documentation and container examples across English, German, Spanish, and Chinese with 1:1 feature parity.
Thanks 💖
Thanks to all contributors and community members who reported issues and provided feedback.
Documentation: https://docs.docmd.io/
docmd Cloud: https://cloud.docmd.io
docmd-assistant: https://github.com/docmd-io/docmd-assistant
docmd-search: https://github.com/docmd-io/docmd-search
Skills: https://github.com/docmd-io/docmd-skills
Full Changelog: 0.8.17...0.9.1
