Shane Spahr // Site
ready
Themes
Site administration
path/blog/engineering-log/markdown-feature-tour
surfaceMarkdown Feature Tour
engineering log // chronology nav // dense article frame

Markdown Feature Tour

Why this page exists

This post proves that a blog page can now load authored markdown instead of falling back to a summary-only shell.

The renderer currently supports a practical subset of markdown with support for raw HTML blocks when you need to drop in a custom shell fragment.

The goal here is not to implement every corner of the markdown spec. The goal is to make authored content usable, readable, and easy to grow.

Feature checklist

  • Headings render inside the article frame.
  • Inline code like dotnet watch run stays monospaced.
  • Links such as the blog index remain clickable.
  • Strong and emphasis formatting both work.

Bring-up steps

  1. Hard refresh a direct route.
  2. Confirm the static shell appears first.
  3. Let the live shell take over.
  4. Read the article body loaded from markdown.

Example command block

dotnet build
dotnet watch run

If this page loads correctly, then the site can now host real authored posts instead of placeholder summaries.