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.

Custom domains

Use your own domain for your documentation site.

Every project deployed with blode.md gets a subdomain at your-slug.blode.md automatically. You can also point your own domain to your docs site for a fully branded experience.

Default subdomain

When you run blodemd push, your docs are published to {slug}.blode.md, where slug is the project slug resolved from --project, BLODEMD_PROJECT, or docs.json slug. No per-project DNS setup is required because the platform wildcard handles *.blode.md.

Add a custom domain

Choose your domain

Decide whether to use a subdomain (e.g., docs.example.com) or an apex domain (e.g., example.com).

Configure DNS

Add a CNAME record pointing your domain to cname.vercel-dns.com.

TypeNameValue
CNAMEdocscname.vercel-dns.com

For apex domains, some DNS providers require an A record instead of a CNAME. Check your provider's documentation for CNAME flattening or ALIAS record support.

Verify ownership

If prompted, add the TXT verification record provided in your project dashboard:

TypeNameValue
TXT_vercel.docs.example.comvc-domain-verify=...
Add the domain in your project settings

Configure the custom domain through Blode.md's custom-domain workflow after your project has been deployed. That control plane provisions the domain on Vercel and returns any verification records you need.

Apex vs subdomain

FieldTypeDescriptionRequired
Subdomain (docs.example.com)RecommendedCNAME to cname.vercel-dns.com. Simplest setup, works with all DNS providers.Yes
Apex (example.com)AdvancedRequires A record or ALIAS/CNAME flattening. Not all DNS providers support this.Yes

Path prefix

If you want your docs mounted at a subpath rather than the domain root, set the path prefix when configuring the custom domain in the control plane.

Your documentation will then be accessible at docs.example.com/docs instead of docs.example.com.