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.

Local development

Preview your documentation locally with real-time reloading.

The blodemd dev command starts a local preview server that renders your documentation exactly as it appears when deployed. Changes to your content and configuration are reflected in real time.

Start the dev server

blodemd dev

This starts the server at http://localhost:3030 and opens it in your default browser.

Options

FieldTypeDescriptionRequiredDefault
-p, --portnumberPort to run the dev server on.Yes3030
-d, --dirstringPath to the docs directory. Defaults to the current directory.Yes
--no-openbooleanDo not open the browser automatically on start.Yesfalse

Examples

blodemd dev -p 4000

How file watching works

The dev server watches your content directory and reloads automatically when files change.

Change typeBehavior
MDX content editIncremental update. Only the affected page is re-rendered.
docs.json editFull reload. Navigation, branding, and all pages are rebuilt.
New or deleted fileIncremental update. Navigation is refreshed automatically.

Ignored directories

The file watcher skips these directories to avoid unnecessary reloads:

  • .git
  • .next
  • dist
  • node_modules