About
What FrontMark is and why this site exists.
FrontMark is a documentation and publishing base for teams that want Markdown to stay readable while still producing rich, structured pages.
It combines Astro, Starlight, Svelte components, Sveltia CMS integration, and MkDocs Material-inspired syntax. The goal is not to replace Markdown with a page builder. The goal is to keep content portable, reviewable, and easy to edit, then let the rendering layer add navigation, visual blocks, diagrams, forms, media, and documentation features.
What this site demonstrates
Content-first authoring
Pages are written in Markdown, including the Astro-facing pages. Astro provides the skeleton, routing, SEO, and runtime structure.
Rich blocks
Admonitions, tabs, buttons, tables, forms, containers, masks, diagrams, and media blocks can be authored from a familiar text format.
Component escape hatch
Svelte is available when a page needs an interactive component instead of static Markdown rendering.
Documentation workflow
The project can be edited locally, previewed with make preview, and managed through the configured CMS when needed.
Why it exists
FrontMark is designed for documentation that has to evolve: internal platforms, product docs, technical guides, integration notes, and project websites where the same content should remain useful in Git, in a CMS, and in a generated static site.
The guiding rule is simple: Markdown owns the content, Astro owns the structure, and FrontMark bridges the two without hiding the source.