# Documents

> A live doc that you, your team and your agents write in at the same time.

Press **New → Document**. Everyone with it open sees each change as it's made, including an agent's.

## What goes in a doc

- Headings, text, lists, checklists and tables.
- Pictures and videos: paste, drop or **Insert** them.
- Embeds: a YouTube, Vimeo, Loom, Figma, Google Docs or Fiddle link on its own line plays in place.
- Code blocks with syntax highlighting, LaTeX formulas and Mermaid diagrams.
- Charts and diagrams your agent draws as `visualization` blocks.
- Live [stories](https://docs.fiddle.fyi/stories.md) from your app: paste a story's link on its own line. Up to four on consecutive lines sit side by side.
- Dates and @mentions of people in the workspace.

## Comment

Select words and press **Comment**. The words are highlighted and the thread sits beside them in the margin. On a phone, a count in the margin opens the comments for those lines.

## Import Markdown

**New → Import…** with a single `.md` file makes it a Document you can edit.

## With an agent

Give your agent the doc's link. It reads the doc with `read_doc` and changes it with `edit_doc`, a section at a time, so you watch it fill in. Each edit is checked against what it read, so it never writes over what someone just typed.

## Versions

When editing goes quiet for a minute, the doc is saved as a version. See [History](https://docs.fiddle.fyi/history.md).
