Purpose

Publish selected Dev notes as part of the broader Express initiative (share what I build and learn). Dev is a subset within Express.

High-Level Flow

flowchart TD
  A["Dev Obsidian vault (Dropbox)"] -->|cron or manual| B["Export + filter publishable notes"]
  B --> C["Deterministic export (normalize MD + assets)"]
  C --> D["Commit + push"]
  D --> E["GitHub repo"]
  E --> F["Cloudflare Pages deploy"]
  E -- "optional" --> G["Cloudflare Worker (hooks, cache, redirects)"]
  • Vault: Dropbox (edit in Vim or VS Code)
  • Trigger: cron job or on-demand CLI
  • Hosting: Cloudflare Pages linked to GitHub
  • Optional: Worker for cache, redirects, or webhooks

Stages

  1. Select & Filter
  • Include notes with publish: true or tag #public/dev.
  • Exclude private/**, inbox/**, scratch/**.
  • Gate via “Worth Publishing” checklist.
  1. Deterministic Export
  • Convert Obsidian wikilinks to standard Markdown links.
  • Normalize headings and generate stable slugs.
  • Copy referenced images to assets/ and rewrite paths.
  • Strip blocks between <!-- internal --> … <!-- /internal -->.
  • Keep output idempotent so diffs stay clean.
  1. Commit & Push
  • Stage changes and commit using Conventional Commits: chore(dev-notes): publish <N> files
  • Alternative: run export + push in CI (GitHub Actions).
  1. Deploy
  • GitHub pushes trigger Cloudflare Pages.
  • Post-deploy (optional): purge cache, ping sitemap.

Worth Publishing Checklist

  • Clear title and one-sentence summary.
  • Sensitive data removed.
  • Links resolve locally.
  • Minimal context added so it stands alone.
  • Dated and tagged.

Work Tracks

  • Pipeline:

    • Add cron on publishing box
    • Export script with filters
    • Link resolver and image copier
    • Cloudflare Pages project and domain
    • Deny-list + secret scan
    • Preview builds for PRs

  • Content:

    • Add new dev notes, how-tos, decision logs
    • Tighten drafts, add diagrams, fix links

Effort Matrix

low effort high effort
tasks small fixes, cache purge build scripts, refactors, CI gates
content tweak notes, add summaries new guides, deep dives, diagrams