Markdown API Issue 8

content/posts/field-notes.md 6 min read

Field Notes From a Tiny Desktop

This page shows what rendered Markdown can look like inside a Gessi window. The output is still plain semantic HTML: headings, paragraphs, links, lists, tables, blockquotes, code, and footnotes.

Author note

Use gessi-document when you control the wrapper, or add class="gs-prose" to an existing generated article.

Why a document wrapper?

Markdown renderers differ, but their HTML vocabulary is stable. Gessi styles that shared vocabulary instead of requiring a custom React component or runtime parser.

Progressive enhancement works best when the document is useful before any component has upgraded.

Publishing checklist

  • Keep headings in order.
  • Use native links for navigation.
  • Add useful alt text to every image.

Package notes

Entry Use
@pol-cova/gessi/css Styles only for generated documents.
@pol-cova/gessi/components SSR-safe custom element registration.

MDX callouts

<div class="gs-callout">
  <strong>Note</strong>
  <p>This survives as plain HTML.</p>
</div>

Footnotes

  1. Footnotes use normal lists and links, so static HTML stays accessible.
Ready - semantic Markdown HTML