Markdown + rules -> static website

SEO-friendly websites from Markdown without CMS or frameworks

Write in your usual Markdown workflow. Notepub builds your site from declarative rules.

🔥 No CMS

no admin panels or databases

📈 SEO by default

sitemap, OpenGraph, JSON-LD, robots.txt

⚡ No JS dependencies

clean HTML, minimal footprint

🔒 You own your content

no platform lock-in

🧠 Flexible structure

you define rules, Notepub does the rest

🔁 Reusable content model

same Markdown and rules for blog, docs, and showcase pages

What You Can Build with Notepub

Ready-to-use solutions without heavy infrastructure

SEO Blog / Digital Garden

Content that indexes and grows without JS-heavy rendering.

Courses / Learning Platforms

Modules, lessons, and progress pages without a CMS.

Technical Documentation / API

Structured docs and references without bulky generators.

Catalog / Showcase

Landing pages and catalogs driven by rules and links.

Internal Knowledge Base

Internal guides, processes, and standards in one consistent structure.

Your Own Format

Describe your model in rules.yaml and build exactly what you need.

One engine, many scenarios.

Publish in 1 click right from Obsidian

Notepub keeps publishing simple: write in Markdown, push changes, and your site is live.

Obsidian-native workflow

Write notes as usual: wikilinks, folders, images near the note. Pre-build normalizes everything for web output.

One push deployment

Edit content, push to GitHub, and Actions handles indexing, build, and deployment automatically.

Fast static delivery

Static pages load quickly, are easy to cache, and work reliably on GitHub Pages without extra servers.

How Notepub Works

Markdown, templates, and declarative rules

Content
in Markdown (Obsidian, Notion, GitHub, S3, local folders)
Theme
prebuilt or fully custom
Rules
types, routes, and relations in rules.yaml
Build
Notepub generates clean HTML, sitemap, and metadata
Deploy
GitHub Pages / VPS / Serverless without heavy ops overhead

Notepub does not impose structure. It executes the structure you define.

Roadmap

What exists today and what comes next

🧱 Core, open-source

A free and self-sufficient foundation.

declarative model (rules.yaml)
Markdown / Obsidian compatibility
clean HTML output
SEO by default (sitemap, JSON-LD, canonical)
GitHub Pages / VPS / Serverless
template-based workflow

Core can be used without accounts, cloud lock-ins, or extra services.

🧩 Templates & Recipes (open + curated)

Ready templates for common scenarios.

SEO blog / personal site / digital garden
documentation
catalog
course
community templates
best practices inside templates

☁️ Notepub Cloud

For teams that want managed infrastructure.

managed build & deploy
static hosting
backend capabilities
engine updates
backups and versioning
domains and SSL

Cloud is convenience, not a lock-in. You can move to self-hosted any time.

🧠 Advanced tooling

Tooling for complex systems and large content bases.

Possible directions:

structure/graph visualization
link and content analysis
AI assistants for generation and refactoring
search / embeddings
content health & consistency

Quick Start

No-code path with minimal setup

Pick a template
Github -> Use this template
Put content into /content or configure S3 credentials
Enable GitHub Pages
Run CI

Learn More ->

Need full flexibility and custom structure? -> Read the docs

Need help or want a site built with Notepub?

We can help with setup, content structure, and launch.

Message us on Telegram or start with docs and launch your site today.

Contact on Telegram Build a site with Notepub

Notepub stays yours: content, rules, and structure remain under your control.