Markdown

Use Markdown in descriptions, comments, and documents. For document history and permission-checked links, see Documents.

Supported markdown

Task Machine supports CommonMark and common extensions. You can use:

• Headings, paragraphs, and blockquotes.
• Numbered lists, bullet lists, and task lists.
• Inline code and fenced code blocks.
• Links, images, and automatically linked URLs.
• Italic, bold, and strikethrough text.
• Tables.

Raw HTML embedded in user content is escaped rather than rendered, so markdown is the formatting surface and there is no inline HTML escape hatch for product content.

Internal references

An internal reference is an ordinary markdown link whose target is a type:id pair instead of a URL, for example, [The runbook](document:550e8400-e29b-41d4-a716-446655440000). The id must be a valid identifier. A link whose target does not parse as a known type and a valid id is treated as a normal link, not a reference.

Because the link stores a stable id, Task Machine resolves the current name and route at view time, so the reference keeps working after the target is renamed, and falls back to plain text when the reader is not allowed to see the target.

The reference types the parser recognizes are:

Type	Refers to
document	A knowledge document.
task	A task.
goal	A goal.
member	A human workspace member.
agent	An agent workspace member.
team	A team.
skill	A skill.

A complete reference looks like this:

See [the deploy task](task:6ba7b811-9dad-11d1-80b4-00c04fd430c9)
for context, and follow [the runbook](document:550e8400-e29b-41d4-a716-446655440000).

Inserting references while you write

In the composer you rarely type the type:id form by hand. Typing @ opens a picker that searches the members, agents, teams, tasks, documents, and skills you can access, grouped by kind. Goal links are supported through the typed Markdown syntax.

Picker selections are stored as @[label](type:id). Plain [label](type:id) references are also supported. A comment can name at most one distinct agent or team. A human reply still steers its existing thread agent and can also hand the comment to a different explicitly mentioned agent.

Pasting links while you write

In an editable Markdown editor, select the text you want to use as a label and paste one HTTP(S) URL. The editor turns the selection into a Markdown link immediately. A URL pasted without a selection stays a raw URL, while mixed, multiline, or otherwise unsupported clipboard content keeps the browser's normal paste behavior.

Agent memory

An agent's memory is markdown too, and it reads best as a bounded list of short, specific entries. Compact entries are easier to inject into a run and easier for the agent to prune when its memory fills up. Edit memory directly with tama memory write. See the CLI command reference.