Skip to content
Robert's Engineering Notes

Sync Markdown Notes

Use this workflow when you want your notes to publish automatically.

Section titled “Recommended setup”
  1. Keep all notes in src/content/docs/software-engineering/ and src/content/docs/projects/.
  2. Use a Git repo (GitHub, GitLab, or Bitbucket).
  3. Connect your host (Cloudflare Pages, Netlify, or Vercel) to that repo.
  4. Configure deploy command as npm run build and output directory as dist.

Daily flow

Section titled “Daily flow”
  1. Create or edit markdown files locally.
  2. Run npm run dev to preview.
  3. Commit and push.
  4. Host rebuilds site automatically.

Optional: notes from another folder

Section titled “Optional: notes from another folder”

If your notes live outside this repo, automate sync with a script:

Terminal window
rsync -av --delete ~/notes/software/ ./src/content/docs/software-engineering/
rsync -av --delete ~/notes/projects/ ./src/content/docs/projects/

Run that script before commit, or schedule it in CI.