Skip to content
Blode.md

AI agents: fetch the documentation index at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.

blodemd dev

Start a local development server for real-time preview.

Run the full Blode.md rendering engine locally so you can preview your documentation as you write.

blodemd dev

How it works

The dev server starts a local Next.js instance that renders your documentation with the same engine used in production. A file watcher monitors your docs directory and triggers automatic browser refreshes when content changes. Changes to docs.json trigger a full server reload.

Options

FieldTypeDescriptionRequiredDefault
-p, --port <port>numberPort number for the local server.Yes3030
-d, --dir <dir>stringPath to the docs directory containing docs.json. Uses the same resolution logic as blodemd push if omitted.Yes—
--no-openbooleanDo not open the browser automatically when the server starts.Yesfalse

Examples

blodemd dev

File watching

The dev server watches all files in your docs directory for changes:

  • Content changes (.mdx, .md, .json files) trigger a hot reload in the browser.
  • Config changes (docs.json) trigger a full server reload to pick up navigation, branding, and API config updates.