Skip to content

Draft content with AI

Use the AI assistant to generate first drafts from a prompt. AI authoring is free on every plan.

Before you begin

  • Open or create a topic to draft into.

Two ways to draft

You can draft new content from either of two surfaces:

  • Inline AI: press Cmd+/ on an empty line, type a description, and the draft appears at the cursor as an accept/dismiss diff. See Inline AI editing.

  • AI chat panel: open the AI Assistant tab in the right sidebar and either click the Draft a section quick action or type your own prompt. See AI chat panel.

Both surfaces are backed by the same writing assistant, which can draft, rewrite, expand, simplify, and improve content. This topic covers drafting; see Rewrite, expand, and summarize with AI for reworking existing text.

Draft from inline AI

  1. Place your cursor on an empty line where you want the content.

  2. Press Cmd+/ (or Ctrl+/ on Windows/Linux).

  3. Type a prompt describing what to write, for example, "Write a getting-started guide for our REST API. Cover authentication, making your first request, and handling errors."

  4. Choose a length (Brief, Standard, or Detailed) and press Enter.

  5. The AI streams its draft and shows a diff preview at the cursor.

Always review and edit AI-generated content before publishing. The AI produces a starting point, not final copy. Check for accuracy, tone, and completeness before making it live.

Draft from the chat panel

  1. Open the AI Assistant tab in the right sidebar (or press Cmd+Shift+/).

  2. Click the Draft a section quick action, or type a prompt in the input.

  3. The AI streams its response. Drafting actions apply at the cursor as an accept/dismiss diff; other responses appear in the conversation.

Apply the draft

Drafts are applied through a diff preview rather than a separate insert button:

  • Accept (Cmd+Enter for inline AI) applies the change to your document.

  • Dismiss (Escape) discards it and restores the original.

  • When the diff spans multiple blocks, you can accept or reject each block individually.

Tips

  • Be specific in your prompts. "Write API authentication docs" produces better results than "Write docs."

  • The chat panel can pull in extra context with @ and # mentions; inline AI works from the current topic and selection.

  • Press Escape to cancel a draft you do not want.

Include structure hints in your prompt. For example, "Write a task topic with numbered steps for configuring SSO, including prerequisites and a troubleshooting section" gives the AI a clear outline to follow.

See also

Was this page helpful?