Architecture artifact

Shell Stack, as a navigable HTML map

This artifact shows the kind of output that is awkward in Markdown: a spatial overview of the stack, grouped by role and connected by flow rather than flattened into one long list.

Content sources

  • content/docs/*.md and content/docs/*.html
  • content/blog/*.md and content/blog/*.html
  • Frontmatter parsed with gray-matter

Build-time pipeline

  • Markdown → remark/rehype → HTML
  • Native HTML → sanitize → HTML
  • Heading extraction + stable anchors

Delivery surfaces

  • Docs/blog pages use a single sanitized HTML boundary
  • Artifact previews use sandboxed iframes
  • Markdown renderer is no longer on the hot path
Markdown / HTML source
→
Compile + sanitize
→
Static HTML export
→
Doc / blog / artifact UI