Shane Spahr // Site
ready
Themes
Site administration
path/blog/engineering-log/generator-workflow-dry-run
surfaceGenerator Workflow Dry Run
engineering log // chronology nav // dense article frame

Generator Workflow Dry Run

Importing a local markdown file

The generator path is intentionally offline. You author a local .md file, run the import script, and let the site consume the generated static asset plus the manifest entry.

Suggested front matter

---
title: My New Note
sectionKey: blog
categoryKey: engineering-log
summary: Short teaser for cards and indexes.
publishedUtc: 2026-03-19T00:00:00Z
tags: blog, generator
---

Example import command

./tools/Import-Markdown.ps1 `
  -InputFile .\drafts\my-new-note.md `
  -SectionKey blog `
  -CategoryKey engineering-log

Expected workflow

  1. Author the markdown file locally.
  2. Run the import script.
  3. Commit the updated static markdown asset and manifest.
  4. Hard refresh the new route and verify the post loads.

There is no in-browser CMS here yet. The short-term workflow is file-first authoring plus offline generation.