Town AI Document

A collaborative document editor where you and your AI assistant work on content together. Research, draft, refine, and export — all in one place.

Overview

Town AI Document is not AI bolted onto a text editor. It’s a shared workspace where you and your assistant co-author content in real time. Your assistant can research the web, pull context from your emails and calendar, summarize attachments, and edit the document directly — while you write alongside it.

Documents use Markdown (CommonMark + GitHub Flavored Markdown) with a WYSIWYG editor, so you get clean formatting without needing to write raw markup.

Getting started

Creating a document

You can create a new document in several ways:

• From the Content page, click New document
• Ask your assistant to create one: “Create a doc summarizing my meeting notes from this week”
• An agent can create documents automatically as part of a workflow

The editor layout

The editor is a split view:

• Left: the document itself — a centered, clean writing surface
• Right: an AI chat sidebar that slides in when you need it

You can resize the split or collapse the chat panel entirely to focus on writing.

Writing and formatting

Supported formatting

The editor supports standard Markdown formatting in a WYSIWYG view:

• Bold, italic, inline code
• Links
• Headings (H1, H2, H3)
• Blockquotes
• Bullet lists and numbered lists
• Code blocks

Keyboard shortcuts

Raw Markdown view

Toggle between the WYSIWYG rendered view and a raw Markdown source view at any time. This is useful for fine-tuning formatting or copying raw Markdown.

Working with your assistant

The AI chat sidebar is your main interface for collaborating with the assistant. Every message you send includes full document context — the assistant always knows what’s in the doc, what you’ve selected, and any comments you’ve left.

Asking the assistant to edit

You can ask your assistant to make changes using natural language:

• “Make the intro more concise”
• “Add a section about pricing at the end”
• “Rewrite the bullet points as a table”
• “Fix the grammar in paragraph 3”

The assistant edits the document inline — changes appear directly in the doc, highlighted so you can see what changed.

Contextual capabilities

Your assistant has access to all its usual tools while working on a document:

• Research the web — find facts, check sources, look up current information
• Pull from your emails — reference past conversations and attachments
• Check your calendar — include meeting details, attendees, scheduling context
• Summarize attachments — extract key points from files
• Cross-reference past conversations — draw on context from other threads

This means document content is grounded in your real data, not generic AI output.

Use case examples

Inline AI features

Slash commands

Type / on an empty line to open an inline AI prompt. A floating input appears right where you’re writing — type your request, press Enter, and the assistant handles it without you needing to switch to the chat panel.

This is great for quick, targeted actions like:

• “Summarize the section above”
• “Add a transition sentence here”
• “Insert a table comparing the three options”

Press Escape or Backspace to dismiss the slash command prompt.

Select + Add to chat

Highlight any text in the document, then click Add to chat in the floating action bar. The selected text is added as context to your chat input, so you can ask the assistant about it specifically:

1. Select text in the document
2. Click Add to chat (or use the floating action)
3. Type your request in the chat — e.g., “Rewrite this to be more formal”

Multi-selection

Hold Cmd/Ctrl and click to create multiple text selections (up to 10). Each selection appears as a chip in the chat input. This lets you reference several parts of the document at once:

• “Combine these three bullet points into a single paragraph”
• “These sections contradict each other — reconcile them”

Comments

You can leave comments on specific text ranges in the document:

1. Select text
2. Click Add comment in the floating action bar
3. Type your comment and save (Cmd/Ctrl + Enter)

Comments appear as highlights in the document. Hover over commented text to see the comment details, author, and timestamp. You can resolve or delete comments from the tooltip.

Batch comment resolution: Leave multiple comments throughout the document, then ask your assistant to resolve them all at once — “Address all the comments in the doc.”

Sharing

Link sharing

Share a document with anyone via a link:

1. Click the Share button in the document header
2. Enable link sharing
3. Copy the generated URL

Anyone with the link can view the document. You can regenerate the link at any time to invalidate previous URLs.

Exporting

Export your document to a variety of formats and destinations.

Direct downloads

• PDF — formatted document as a PDF file
• Word (.docx) — Microsoft Word document
• Excel (.xlsx) — spreadsheet format (useful for tabular content)

Cloud integrations

• Google Docs — create a new Google Doc with the document content
• Google Sheets — export tabular content to a spreadsheet
• Notion — send to a Notion page
• Dropbox — save as PDF, Word, or Excel to Dropbox

Communication tools

• Email — create a draft, or attach as PDF/Word/Excel
• Slack — send as a message, or upload as PDF/Word/Excel

AI-assisted export

You can also ask your assistant to handle the export: “Send this as a PDF to the marketing Slack channel” or “Create a Google Doc from this.”

Email drafts

Documents can be linked to email drafts. When you create a document from an email context, it can include:

• Email metadata (to, subject, cc, bcc)
• A link to the corresponding Gmail draft
• The ability to send the document as an email directly

Content Library

All documents automatically appear in the Content Library (/content), where they can be:

• Organized into collections
• Searched by title or content
• Filtered by type or origin
• Previewed with a single click

Tips and best practices

• Use slash commands for quick edits — they’re faster than switching to the chat for small changes.
• Leave comments for batch editing — annotate your doc with what you want changed, then ask the assistant to address everything at once.
• Use multi-selection — when you need the assistant to work with multiple parts of the document, Cmd/Ctrl + Click to select them all.
• Leverage your real data — ask the assistant to pull in emails, calendar events, and past conversations. Documents grounded in real context are much more useful than generic AI-generated content.

Related

• Assistant — the main chat interface; documents created in assistant threads open in the detail panel
• Web App — overview of the Town web app