Editor

The Editor is the primary interface for creating and editing content in Product Graph. Built on a modern rich-text foundation, it provides a distraction-free writing experience with powerful formatting tools, AI assistance, and seamless collaboration.

​

AI-Powered Writing

The editor integrates AI assistance directly into your writing workflow.

​

Selection-Based Editing

Highlight specific text to access AI-powered editing:

• Expand: Elaborate on selected content
• Summarize: Condense lengthy passages
• Rewrite: Improve clarity or tone
• Custom instructions: Provide specific guidance for how to modify the selection

The AI generates suggestions as tracked changes, allowing you to review, accept, or reject each modification.

​

Change Tracking & Review

Every AI-generated edit is presented as a tracked change for your review. This ensures you always have full control over what content makes it into your documents—nothing is applied silently.

​

Visual Change Indicators

Changes are displayed inline with clear visual formatting:

​

Change Navigation

​

Accepting and Rejecting Changes

Review each change individually or handle them all at once:

​

Change Tracking in Collaboration

When multiple users are viewing a document during AI generation:

• All users see the same tracked changes in real-time
• Any user can accept or reject changes
• The document state stays synchronized across all sessions

This makes it easy for teams to collaboratively review AI-generated content.

​

Block-Based Editing

The editor uses a block-based approach where content is organized into discrete blocks that can be easily created, rearranged, and formatted.

​

Quick Insertion with Slash Commands

Type / anywhere to open the command menu. Search or browse available blocks and formatting options:

​

Text Formatting

Apply rich formatting to your text using keyboard shortcuts or the formatting toolbar.

​

Inline Formatting

​

Block Formatting

​

Artifact Mentions

Reference other artifacts in your documentation using mentions. Type @ to search and insert links to any artifact in your product. Mentions support all artifact types:

• Products, Capabilities, Features, Requirements, Acceptance Criteria
• User Types, Core Entities, Projects
• Documents (Pages)

When you insert a mention, it creates an inline link that readers can click to navigate directly to the referenced artifact. The editor provides autocomplete suggestions as you type, filtering by artifact name or type.

​

Images

The editor provides flexible options for adding images to your documentation.

​

Adding Images

• Slash command: Type /image to trigger the upload dialog
• Drag and drop: Drag images directly from your desktop into the editor
• Paste: Paste images from your clipboard (⌘/Ctrl + V)

​

Image Controls

Once inserted, images can be:

• Resized: Drag the edges to adjust width (0–100% of container)
• Aligned: Position left, center, or right within the document

Supported formats include JPEG, PNG, GIF, and WebP.

​

Links

​

External Links

Highlight text and press ⌘/Ctrl + K to add a hyperlink to an external URL. The link editor provides options to edit or remove links.

​

Internal Artifact Links

Use @mentions to create links to other artifacts. These links are contextual and update automatically if the artifact’s title changes.

​

Tables

Insert tables using the /table command. Tables support:

• Header rows: The first row is styled as a header
• Column and row management: Add or remove rows and columns through context menus
• Cell selection: Click and drag to select multiple cells
• Column resizing: Drag column borders to adjust width

​

Code Blocks

Create code blocks with /codeblock for displaying code snippets with syntax highlighting. The editor automatically detects the programming language and applies appropriate syntax coloring.

​

Markdown Support

The editor understands common Markdown syntax as you type:

​

Version History

Every document maintains a version history. Access previous versions to:

• Review how a document evolved over time
• Compare changes between versions
• Restore earlier versions if needed

Versions are created automatically when changes are saved and can be browsed through the versions drawer.

​

Autosave

Changes are automatically saved as you type. The editor uses real-time synchronization, so your work is preserved even if you close the browser or lose connection temporarily.

---