Workspaces

Documentation

Write a living project brief with searchable sections, brand elements, references, and checklists.

Documentation is a continuous rich text document. Use it for the project overview, goals, stakeholders, design guidance, research, and delivery checks. You can add or remove sections as the project develops.

Add and organise sections

Choose Section or Add section, give it a title, and write directly below it. The title automatically appears in On this page on the right. Select an outline entry to jump to it.

Drag a section's grip in the outline to reorder the whole section, including its text and elements. You can also focus the grip and use the up/down arrow keys. On smaller screens, use the On this page selector and the move controls beside it.

Use a section's remove control to remove it. Undo can recover an accidental removal during editing; History provides recovery from saved versions.

Write and format text

The toolbar provides bold, italic, bullet and numbered lists, subheadings, and links. Ordinary text works well for scope, decisions, tone of voice, and open questions. Specialised elements give visual guidance and checklists their own presentation.

Click a text link to edit its address, open it, or remove the link while retaining its text. Ctrl/Command-click opens it directly. Ctrl/Command + K adds or edits a link at the current selection.

Insert documentation elements

Place the cursor where the element belongs and use its toolbar icon. Each icon shows a quick key, which works when you are not typing into text or a field.

KeyElementUse it for
1ReferencesBriefs, research, brand assets, and design inspiration, with a title, link, and context.
2ChecklistDelivery requirements, review tasks, and pre-flight checks with completion states and notes.
3Colour paletteNamed colour swatches and HEX values that make the brand direction clear.
4TypographyFont roles, families, weights, and styles with a visual preview.

Element delete controls sit on the far right of their headers. Deleting a card removes that element; it does not remove its containing section.

References

Give each reference a useful title and explain what it contributes. Use its open control to follow the link and its editing controls to update it. Skafold stores the link and description, not the external file. Check that intended readers have access to the source.

Checklists

Create separate checklists for design review, content collection, accessibility, launch, or handoff. Record findings and remaining work in item notes instead of relying on completion state alone.

Colour palettes

Name each colour by its role or agreed brand name. Enter its HEX value or use the colour picker; the swatch reflects the value. Add surrounding text to explain contrast requirements, backgrounds, accents, and combinations to avoid.

Typography

Add role-and-font pairs such as Heading, Body, UI, or Monospace. Choose a weight and optional Italic style. Open Font details to set a reference link, preview source, and fallback.

Google Fonts and Fontshare previews load in the browser. Other sources can use a public HTTPS font-file URL; licensed fonts can use an installed local font. If a font or variant is unavailable, the preview uses the fallback. Keep hierarchy and usage guidance alongside the element.

Search the document

Use Search documentation or Ctrl/Command + F while this workspace is open. Search includes section titles, prose, colour names and HEX values, font names, reference details, and checklist notes.

Select a result in the outline or move through matches with Enter, Shift + Enter, or the arrow controls. Clear the search to return to normal section navigation.

Copy and paste Markdown

Paste Markdown into the editor to convert headings, lists, emphasis, links, and task lists. For an explicit conversion, choose Markdown → Paste Markdown, paste the text, and select Insert Markdown.

  • # and ## headings create sections in the outline.
  • Deeper headings stay within a section.
  • Copy document as Markdown and Copy selection as Markdown let you take content into another tool.
  • Colour and typography elements become readable lists of names and values. Pasting that Markdown back does not recreate the specialised cards; normal copying within Skafold preserves them.
  • Unsupported tables remain readable text.

Review the result after pasting, especially when bringing in a long document with existing headings.

Collaborate and recover

Connected team members can edit together, with names and editing positions visible in the document. Undo reverses your own document edits. Wait for Saved in the main header before closing the project.

Open History in the main header to inspect changes, name a milestone, or preview a saved document. A restore replaces the whole Documentation workspace, so review the comparison and coordinate with other editors first. See History, milestones, and restore.

The project overview displays these same rich text and specialised elements in view-only mode. To update the published plan used by AI tools, save your work and choose AI Context → Update AI Context when available.