Cloudflare Deployment

mdorigin does not ship a repo-owned wrangler.toml. Instead, it generates a Worker bundle for the consuming project.

Recommended install:

npm install -g mdorigin

Project-local install also works with npm install --save-dev mdorigin.

Build a Worker bundle

mdorigin build cloudflare --root docs/site

By default this writes:

dist/cloudflare/worker.mjs

For media-heavy sites, use external binary mode:

mdorigin build cloudflare --root docs/site --binary-mode external

In external mode:

• text content stays embedded in worker.mjs
• smaller binaries are staged under dist/cloudflare/assets
• oversized binaries are staged under dist/cloudflare/r2
• generated Wrangler config wires the staged asset directory to the ASSETS binding
• dotfiles and dot-directories are ignored during traversal

When --search <search-dir> is provided to build cloudflare, the search bundle is also externalized for Cloudflare deployments:

• search files are not embedded into worker.mjs
• smaller search files are staged under dist/cloudflare/assets/__mdorigin/search
• oversized search files are staged under dist/cloudflare/r2
• /api/search loads the staged index lazily at runtime

Initialize Wrangler config

mdorigin init cloudflare --dir .

If the bundle contains R2-backed binaries, pass the bucket name:

mdorigin init cloudflare --dir . --r2-bucket <bucket-name>

Upload staged R2 objects before deploying:

mdorigin sync cloudflare-r2 --dir dist/cloudflare --bucket <bucket-name>

This upload step can be required by large media files, large search bundle files, or both.

If --name is omitted, mdorigin derives the Worker name from the site title.

You can deploy to the default *.workers.dev hostname first. A custom domain is optional and can be added later from the user project's Cloudflare setup.

For production deployment, set siteUrl in mdorigin.config.json so rendered HTML and /sitemap.xml can use the correct absolute origin.

After deployment, extensionless routes on the Worker can also return markdown when a client sends:

Accept: text/markdown

That lets agents fetch markdown directly from the site domain without adding .md to the URL.