Skip to content

Building the Articles Section

A quick tour of what these articles support: Markdown, Mermaid diagrams, images, and syntax-highlighted code.

By Mishigo OÜ · July 24, 2026

Articles here are plain Markdown files in src/content/articles/. They support everything you’d want for technical writing.

Mermaid diagrams

Fenced ```mermaid blocks render as diagrams in the browser:

flowchart LR
  A[Write Markdown] --> B{Has a diagram?}
  B -->|Yes| C[Render with Mermaid]
  B -->|No| D[Plain prose]
  C --> E[Published article]
  D --> E

Code sections

Fenced code blocks are syntax-highlighted at build time via Shiki:

export function greet(name: string): string {
  return `Hello, ${name}!`;
}

Images

Standard Markdown images work — drop files in public/images/ and reference them:

Mishigo logo

That’s it. Add a new .md file to publish a new article.

← All articles