fallbackMessage

docmd v0.8.4 Launchpad 🚀

Build production-ready documentation from Markdown in seconds.

This release focuses on deployment improvements, safer plugin behaviour, and stability fixes across the development server and UI.

✨ Highlights

Deployment targets

The deployment system has been moved into a dedicated @docmd/deployer package with provider-based deployment targets.

You can now generate deployment files directly for GitHub Pages, Vercel, and Netlify:

docmd deploy --github-pages
docmd deploy --vercel
docmd deploy --netlify

Generated files automatically use values from your docmd.config.json, including the output directory, site URL, SPA routing, and Node.js version.

Existing deployment targets for Docker, Nginx, and Caddy continue to work unchanged.

Markdown line breaks

A new markdown.breaks option has been added to docmd.config.json.

Set this to false to disable automatic markdown line breaks and preserve wrapped markdown formatting.

{
  "markdown": {
    "breaks": false
  }
}

Changelog

  1. Deployer: The deployment engine was extracted into @docmd/deployer, adding native, auto-configured target support for GitHub Pages, Vercel, and Netlify (docmd deploy).
  2. Markdown formatting: Added markdown.breaks configuration option to globally toggle automatic soft wrap line breaks.
  3. Security hardening: Locked down plugin installs to enforce official npm registry boundaries and mitigated unsafe shell-based spawn processes.
  4. Security hardening: Restricted HTML rendering in @docmd/plugin-threads comment inputs.
  5. CLI robustness: The parser and build hooks now exit with non-zero codes on plugin failures, improving CI build pipeline reliability.
  6. Developer experience: Reduced dev-server output noise during hot-reloads and added filePath arguments to parser lifecycle hooks.
  7. UI alignment: Revamped the version switcher with Lucide icon indicators and unified the Project Switcher pills and list items with standard theme dropdown styles.
  8. UI bugfixes: Fixed project-switching cached page overlaps, XHR translations on noStyle pages, and copy-code icon hover states.

docmd CLI & Ecosystem

The core engine is free and open-source under the MIT license. Check out the Documentation to learn more about advanced configurations, versions, themes, and plugins.

Thanks 💖

Thanks to all contributors and issue reporters who helped make this release possible! Special thanks to security researchers for coordinating responsible disclosures.

https://github.com/docmd-io/docmd

next 概览