Blog formatting example

This is a deliberately practical reference, not a personal story. It shows the elements available when writing a post in plain Markdown.

A small illustration

An abstract page with a heading, short lines of text, and a highlighted note. — An original local SVG illustration used to verify responsive image rendering.

Everyday Markdown

Lists keep related points easy to scan.
Bold text, emphasis, and inline code stay distinct.
Links remain ordinary links.

Good formatting should clarify the writing, not compete with it.

A table

Element	Use it for	Mobile behaviour
Heading	A new idea	Wraps naturally
Table	A compact comparison	Scrolls within the article
Code	A concrete example	Scrolls within the article

A Java example

record Note(String title, boolean published) {
  boolean isVisible() {
    return published && !title.isBlank();
  }
}

Astro provides this syntax highlighting through its built-in Shiki integration; no client-side highlighting library is loaded.

A simple diagram

A three-step diagram showing Markdown, Astro build, and public blog page. — An original SVG diagram of the static publishing path.

Writing a post

Create a .md file in src/content/blog/. Its frontmatter needs a title, description, lowercase kebab-case slug, draft, and publication date. Set draft: true to keep a post out of the generated site.