FrontMark

FrontMark is the frontend-facing Markdown layer used by FrontMark documentation. It keeps the authoring experience close to MkDocs Material while adding project-specific directives for richer generated pages: containers, charts, forms, videos, parallax scenes, n8n workflows, hexadecimal viewers and runtime-oriented visual blocks.

What It Is Made With

FrontMark is built on Astro and Starlight for the static documentation shell, then extends the Markdown pipeline with remark and rehype transforms. Svelte is used when Markdown needs real frontend components: stateful previews, editors, interactive controls, generated views or blocks that cannot stay as static HTML. That pipeline keeps normal Markdown readable while adding support for MkDocs Material-style syntax, custom directives and richer frontend blocks.

The renderer combines a few focused layers:

Markdown remains the source format for pages, references and authoring.
Astro provides the page structure, routing, layouts and build output.
Starlight provides the documentation frame, navigation, responsive sidebar and content ergonomics.
Svelte provides focused interactive components when a page needs state, runtime behavior or richer controls.
FrontMark transforms add containers, masks, charts, forms, videos, parallax blocks, hexadecimal views and workflow embeds.
Shared CSS tokens keep the visual language consistent across the documentation and the sigMAX-flavored theme.

What It Is For

FrontMark is made for documentation that needs to stay easy to write, easy to review and richer than plain prose once published. It helps teams document software, generators, visual systems and operational workflows without turning every page into a bespoke frontend component.

Use it when a page needs structured explanations, diagrams, callouts, tabbed snippets, media, generated previews or compact interactive blocks. Keep the source in Markdown, let the rendering layer do the presentation work, and reserve custom code for the places where Markdown genuinely needs help.

Key Capabilities

Portable Markdown

Keep pages readable in source control while adding MkDocs Material-style syntax, attributes, tabs, admonitions and rich content blocks.

Visual containers

Build full-width documentation sections with backgrounds, masks, animated transitions and reusable presets.

Diagrams and data

Render architecture diagrams, charts, tables, math and technical visualizations directly from Markdown.

Media and workflows

Embed videos, terminal recordings, parallax scenes, hexadecimal views and copyable n8n workflows without leaving the authoring flow.

Svelte components

Add stateful previews, editors and focused interactive tools when static Markdown needs a real frontend component.

Configurable theme

Centralize layout, navigation, search, colors and sigMAX styling through shared configuration and CSS tokens.

Ecosystem Boundary

FrontMark can be used around the sigMAX ecosystem as a publishing and documentation layer, but it remains separate from the sigMAX generator, runtime and contract model. See FrontMark in sigMAX for the concise boundary note imported from the devsite context.