obsidian-cloudflare-pages

# OpenClaw Skill: Obsidian/Markdown → Cloudflare Pages

This is an **OpenClaw Skill** for publishing Markdown to Cloudflare Pages.

- Works with Obsidian vault folders **or any Markdown folder**
- Originally built for reading Obsidian Web Clipper output:
  - https://obsidian.md/clipper

Automates a safe publishing flow:
1. Select notes from your source folder
2. Sync to a publish workspace
3. Build static HTML with Quartz
4. Deploy to Cloudflare Pages

## Commands

- `node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js init`
  - Creates `config/config.json` from example
- `node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js wizard`
  - Interactive setup wizard for config (vault, folders, site/domain, Cloudflare project)
- `node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js setup-project`
  - Initializes Quartz project in configured workspace if missing
- `node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js doctor`
  - Validates paths + required binaries
- `node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js sync`
  - Syncs selected notes/assets into publish content folder
- `node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js build`
  - Runs Quartz build in project dir
- `node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js deploy`
  - Deploys to Cloudflare Pages with wrangler
- `node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js run`
  - sync → build → deploy
- `node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js run --dry-run`
  - previews actions without mutating files or deploying

## Config

Copy and edit:

`skills/obsidian-cloudflare-pages/config/config.example.json` → `skills/obsidian-cloudflare-pages/config/config.json`

### Safety defaults
- Publish allowlist by folder
- Optional `publish: true` frontmatter gate
- Exclude private folders by default

## Requirements

- `node` 20+
- `rsync`
- `npm`
- `npx quartz`
- `wrangler`

## Cloudflare API token setup (recommended)

Create a Cloudflare API token with...

# OpenClaw Skill: Obsidian/Markdown → Cloudflare Pages (YOURDOMAIN.COM)

![OpenClaw Skill banner](assets/github-banner-v2.svg)

## Overview

This OpenClaw Skill automates publishing selected Obsidian notes (or any Markdown folder) to a static website on Cloudflare Pages.

It includes:
- Interactive onboarding wizard
- Vault folder sync
- Quartz build + deploy
- Optional Basic Auth protection (config or env-backed)
- Safer execution controls (`--dry-run`, destructive guard)
- Branded index pages
- `🔗 Copy Link` button next to each page title

> Replace `YOURDOMAIN.COM` with your real domain/subdomain (for example, `docs.example.com`).

---

## What’s Included

### 1) CLI workflow (`publishmd-cf.js`)

Commands:

- `init` — create config from example
- `wizard` — interactive setup
- `setup-project` — initialize Quartz workspace if needed
- `doctor` — dependency/env/path checks
- `sync` — copy selected vault folders into Quartz content
- `build` — build static site + post-processing customizations
- `deploy` — deploy to Cloudflare Pages
- `run` — full pipeline (`setup-project -> doctor -> sync -> build -> deploy`)

---

### 2) Config + env support

- Config file:
  - `skills/obsidian-cloudflare-pages/config/config.json`
- Config template:
  - `skills/obsidian-cloudflare-pages/config/config.example.json`
- Local secrets file:
  - `skills/obsidian-cloudflare-pages/.env`
- Env template:
  - `skills/obsidian-cloudflare-pages/.env.example`

The CLI auto-loads skill-local `.env` without overriding already-set shell env vars.

---

### 3) Basic Auth support

Wizard supports:

- `cloudflare.basicAuth.enabled`
- `cloudflare.basicAuth.username`
- `cloudflare.basicAuth.password`

On deploy, middleware is generated automatically at:

- `<workspace>/functions/_middleware.js`

If enabled, site requires HTTP Basic Auth.

---

### 4) UI customizations applied at build

Post-build transformations:

- Promote `/Clippings/index.html` -> `/index.html`
- Brand root and clippings index page...