Skip to main content
This page covers Markdown documents: specs, tickets, stories, and reviews. For other types, see HTML artifacts, Canvases, and File artifacts. Open a document from the Artifacts panel to edit it in a panel. Edits save as you type, and everyone with the Task open sees them live. Collaborators’ cursors appear in the text while you co-edit.

Titles

An artifact you create in the app opens with an empty heading at the top, where the cursor starts. Until you rename the artifact, its title in the panel and on the tab follows that first heading as you type. Once you rename the artifact from the panel, the heading and the title are independent.

Formatting Toolbar

Select text to show the formatting toolbar: Two actions sit beside the formatting buttons:
  • Comment (⌘⌥M / Ctrl+Alt+M) starts a comment thread on the selection. See Comments.
  • Send to chat hands the selection to an agent chat. See Send to Chat.
In a narrow panel the formatting buttons fold into one Aa button. Select text and click Link, or press ⌘K / Ctrl+K, to open Edit link. It has two fields, Page or URL and Link title, and Remove link when you edit an existing link. To link to another artifact, enter its folder as a relative path, such as ../sibling-ticket for a sibling or child-artifact for a child. See Artifacts on Disk for the folder layout. Hover a link to see a preview card with Copy link and, for Editors and Owners, Edit.

Images

Paste or drop images into the body. Each image can be up to 30 MB.

Diagrams and Wireframes

Type a code fence named mermaid or wireframe and it turns into a live block after a short pause:
  • Diagrams render Mermaid source as a diagram.
  • Wireframes render a self-contained HTML document as a live preview.

Structure and Navigation

  • Nested artifacts. When an artifact has children, a list of them appears under its body. Click a row to open that child.
  • Table of contents. An outline beside the body lists the artifact’s level-1 and level-2 headings, so you can jump through a long document.
  • Syncing. If the connection to the host drops while an artifact is open, a thin bar moves along the edge of the artifact until it reconnects. If it takes a while, or with reduced motion turned on, the bar stays still. The text you see may be out of date until then.
  • Drag onto the canvas. Drag an artifact card from a chat, a row of the nested list, or a spec or ticket reference onto the canvas to open that artifact in its own panel.

Send to Chat

Select a passage and click Send to chat to quote it in an agent chat. The menu lists:
  • Open: chats that already have a panel open in this Task tab.
  • Other chats: the rest of the Task’s chats.
  • New chat: always at the bottom.
The quote, followed by a reference to the artifact, is added to that chat’s draft and the chat comes forward. Nothing is sent until you send the message. New chat opens the new-conversation dialog with the quote already in place.