Build Markdown docs into static sites

ZeroPress Build Pages turns a Markdown source directory, optional public assets, and a ZeroPress theme into static HTML output.

Use it for documentation sites, project guides, and lightweight content sites that should deploy cleanly to GitHub Pages, Cloudflare Pages, Netlify, Vercel, or any static host.

How It Fits Together

Build Pages is the Markdown front end for the ZeroPress static build pipeline. You bring Markdown; Build Pages discovers pages, reads optional config, and hands prepared data to a ZeroPress theme that renders the final HTML.

Markdown documents + Build Pages config + ZeroPress theme
  -> static HTML output

You do not need a framework project to start. A single index.md is enough for a first build, and you add config, public assets, or a custom theme only when you need them. See Getting Started for the first build, or Themes for how themes consume the build data.

Common Workflows

Most projects use one of these entry points:

Direct npx Command

Use this when you want the shortest local build or provider build command.

npx --yes @zeropress/build-pages --source ./docs --destination ./_site

GitHub Action

Use this when GitHub Pages should build and deploy the site from CI.

- name: Build ZeroPress Pages
  uses: zeropress-app/zeropress-build-pages@v0
  with:
    source: ./docs
    destination: ./_site

package.json Script

Use this when you want the Build Pages package recorded in package-lock.json and reused through npm run build.

npm install --save-dev @zeropress/build-pages

{
  "scripts": {
    "build": "zeropress-build-pages --source ./docs --destination ./_site"
  }
}

Then run:

npm run build

See Package Manifest for public assets, custom themes, and Pagefind postbuild examples.