Media, Tables, and Diagrams

Rich notes need more than paragraphs. Orbit supports images, tables, code snippets, videos, and diagrams.

Images

Use images for screenshots, design references, diagrams, and evidence.

When you add an image to a note, Orbit stores the image with the workspace and shows it in the note.

To add an image:

1. Place the cursor where the image should appear.
2. Choose the image insert option.
3. Choose the image file.
4. Add nearby text that explains what the image shows.

Before sharing, confirm the image is visible to the intended audience.

Tables

Use tables when rows and columns make the note easier to scan.

Use tables for owners, statuses, decisions, dates, lightweight registers, and comparisons. Keep tables narrow enough to read on a laptop screen.

Code snippets

Use code snippets for commands, config, payload examples, logs, and short examples.

Add a language name when you want syntax highlighting, such as bash, json, or ts.

Diagrams

Use Mermaid diagrams for flows, sequences, architecture sketches, and dependencies.

Example:

```mermaid
flowchart LR
  Writer --> Orbit
  Orbit --> Microsoft365[Microsoft 365 storage]
  Orbit --> Collaborators
```

If a diagram does not render, check the Mermaid syntax and keep the diagram small enough to review in the editor.

Videos

Orbit supports video references for external and internal videos, including YouTube and Microsoft Stream links.

Paste the video link into the note and add context above or below it so readers know why the video matters.

Table of contents

Long notes can include a table of contents. Add one near the top when the note has several sections and readers need to jump around.