mdserve started as a general-purpose markdown preview server. Over time, it became clear that its strongest use case was something more specific: acting as a live rendering companion for AI coding agents. The zero-config design, instant live reload, and support for GFM tables, code blocks, and Mermaid diagrams are precisely what you need when an agent is writing markdown in your terminal, and you want to read it in a browser.
This release makes that focus explicit. The README, crate description, and project documentation have been rewritten around the agent-companion workflow. I'm cutting 1.0.0 because the core feature set (single-file and directory serving, live reload via WebSocket, theme support, and frontmatter handling) is stable and has been since 0.5.1. There are no breaking changes; this is the same mdserve, with a clearer identity.
Features
- Add
--openflag to launch browser automatically (#59) - Add Claude Code plugin metadata and mdserve skill (#60)
Refactoring
- Convert to binary-only crate (#58)
Documentation
- Rewrite README for AI agent companion focus
- Add CLAUDE.md for AI agent contributors
- Add changelog workflow to CLAUDE.md
Build
- Add crates.io publishing to workflow
Miscellaneous
- Update crate description to match new focus
- Skip release commits in git-cliff output
Full Changelog: v0.5.1...v1.0.0