404 page

Customise the not-found page with a standard Markdown file.

404 page

Create a 404.md file in the docroot to customise the not-found page. It is processed through the full pipeline including the view template, giving it the same look as the rest of the site.

Syntax

---
title: Not Found
---
The page you requested could not be found.

[Return to the home page](/)

Location

The file must be at the docroot root: public_html/404.md. It generates 404.html which is cached and served for subsequent 404 responses.

Behaviour

When a request matches no .md or .url file, the processor:

  1. Checks for 404.md in the docroot
  2. If found and 404.html cache is fresh (mtime check), serves cache
  3. If found but stale or no cache, processes through process_md with the full pipeline and view template, caches result
  4. If 404.md does not exist, returns a bare HTML fallback showing the requested path

The response always returns HTTP status 404 Not Found regardless of whether a custom page exists.

Example

---
title: Page not found
subtitle: Sorry, that page doesn't exist.
---
## Nothing here

The page you're looking for may have moved or been removed.

Try the [home page](/) or use the navigation above.

Notes