features
pages is a minimal static site generator. here's what it does:
content
- markdown pages with yaml frontmatter for metadata
- ascii mermaid diagrams rendered as preformatted text
- code blocks with optional filename headers
- tables, alerts, and standard gfm syntax
- heading anchors for direct linking to sections
seo & social
- og images auto-generated per page (1200x630 png)
- sitemap.xml and robots.txt
- llms.txt and llms-full.txt for ai crawlers
- canonical urls with proper base path handling
theming
- 16+ light/dark color themes for the site and code blocks with system preference detection
- color theme picker in header
- persistent preference via localstorage
developer experience
- raw .md links for every page
- live reload during development
- github pages ready (works under subpaths like
/pages)
security
- safe html escaping
- strict url/path handling
- content security policy headers
see also:
- markdown features - frontmatter, mermaid, code blocks, alerts
- configuration - config.yaml reference
- deployment - github pages setup