Skip to content
LoidoltTheme 0.11.1
Svelte 5

Component

MarkdownPage

A whole documentation page: title and description from frontmatter, the document, its contents and previous/next links.

import { MarkdownPage } from '@loidolt/theme-docs';

Example

Guide

Cutting your first job

From an uploaded file to a finished part, in five steps.

This guide walks through a job from upload to pick-up. It assumes the machine is set up and calibrated — see Calibration if not.

Prepare the file

Export your drawing as SVG with outlined text and strokes at 0.01 mm. Anything thicker is engraved rather than cut.1

export.ts
// Outline text so the machine sees paths, not fonts.
export function prepare(svg: SVGSVGElement): SVGSVGElement {
  for (const text of svg.querySelectorAll('text')) outline(text);
  return svg;
}

Save a template

Keep a template with the bed size and a safe margin already drawn in.

Choose a material

Material Thickness Speed (mm/s) Power
Birch ply 3 mm 18 70%
Cork 2 mm 40 35%
Acrylic 3 mm 12 80%
Kerf
The width of material the beam removes — about 0.15 mm on birch.
Focus
The height at which the beam is narrowest. Set it with the gauge, not by eye.

Warning

Never cut PVC or vinyl: the fumes are toxic and corrode the machine.

Run the job

  1. Place the sheet against the rear fence.
  2. Frame the job to check it fits.
  3. Close the lid and start.
graph LR
  Upload --> Prepare --> Frame --> Cut --> Collect

Before you leave

  • Extraction running
  • Lid closed
  • Offcuts sorted for reuse

Calibration

Run the calibration card monthly, and whenever you change the lens.

Footnotes

  1. Some drawing programs round hairlines up; check the exported file, not the drawing. ↩

Notes

  • The document’s own # heading becomes the page title and is left out of the body, so the page has exactly one level-1 heading.
  • The contents sit beside the page on wide screens and behind an "On this page" button on narrow ones.

Props

Generated from the component source, so it cannot drift from the implementation.

MarkdownPage props
PropTypeDefaultNotes
class string—
description string—Defaults to the frontmatter description.
eyebrow string—Defaults to the frontmatter eyebrow or section.
footer Snippet—Content after the document, before the previous/next links.
next DocsLink—
nextLabel string'Next'
options MarkdownOptions{}
pagerLabel string'More pages'Names the previous/next navigation.
previous DocsLink—
previousLabel string'Previous'
ref bindableHTMLDivElement | nullnull
result RenderedMarkdown—A result rendered ahead of time — pass stripTitle: true when rendering it.
source string''
title string—The page title. Defaults to the frontmatter title, then the document's first # heading, which is left out of the body so the page has one level-1 heading.
toc booleantrueShow the table of contents beside the page (behind a button on narrow screens).
tocTitle string'On this page'

Plus the attributes of HTMLAttributes<HTMLDivElement>, forwarded to the root element.

Loidolt Theme · Svelte 5 · Jost + Archivo · MIT