markdown-it-container

I've been exclusively using Markdown for all docs for several years which I've found to be the most productive format for writing docs. My preferred setup now being to use VS Code with a browser running a local instance of https://vitepress.vuejs.org which instantly live reloads content on each save and renders our custom server components exactly as it looks when published. Its biggest benefit is its extensibility which lets you embed interactive Vue Components directly in the docs, which we've made liberal usage of in our latest product release with tabbed components & online project creator embedded directly in the release notes, e.g: https://docs.servicestack.net/releases/v6#todos-mvc A lighter weight extensibility option is to extend it [1] with custom block-level custom containers using markdown-it-container [2] which lets you creat

Look like you are correct. I had thought the `::: section` syntax was a recommended approach (if not yet part of the formal spec). In the past, I have used various home grown solutions to this, but recently I have been using markdown-it and the accompanying plying markdown-it-container. On the CommonMark forums, I see that the ::: syntax is a leading contender, but that CommonMark itself will not address extensions to basic markdown until after the spec reaches 1.0 https://github.com/markdown-it/markdown-it-container

There's a markdown-it plugin that implements container blocks as described: https://github.com/markdown-it/markdown-it-container Not an official part of the spec, but certainly something this CMS could support since you'd just parse the markdown it saves with whatever parser you choose with your static generator.