Write and edit

Use the editor to write Markdown, review suggestions, and add media. The Live and Source views edit the same document text.

Choose a document view

Use Live to edit a rendered document. Headings, links, tasks, tables, media, and supported fenced components render in place. Move the caret into a rendered range when you need to edit its Markdown directly.

Use Source when exact syntax matters, when you are pasting a larger Markdown block, or when you want a wider monospace editing surface.

Both surfaces edit the same text.

Choose an editing mode

Edit changes canonical Markdown as you type. It requires edit access.

Suggest records a proposed insertion, deletion, or replacement without changing canonical Markdown. An editor can accept or reject it later.

Read hides writing controls.

Your effective role determines which modes are available.

Write Markdown

The following example combines headings, tasks, and a table:

# Launch plan

## Before release

- [ ] Verify the build
- [ ] Publish the notes

| Owner | Work | State |
| --- | --- | --- |
| Alex | Build | Ready |
| Agent | Notes | In progress |

Use descriptive headings and stable labels. They make comments, suggestions, and agent edits easier to anchor.

Add files

With edit access, upload image, audio, or video files from the document toolbar. AgentsMarkdown stores the file and inserts portable Markdown that points to the document asset.

Supported uploads include PNG, JPEG, GIF, WebP, MP4, WebM, WAV, MP3, MP4 audio, Ogg, and WebM audio. For the upload limit, see Limits and formats.

Keyboard and accessibility

The editor supports keyboard navigation, visible focus, and semantic controls. Browser and operating-system editing shortcuts continue to work. On narrow screens, panels appear after the document.

Add document components

Boards, chats, sheets, charts, and widgets are written as fenced Markdown. The browser can render them as useful controls, and agents can read and edit the source.

See Live components.