Comments

Overview

Comments let you:
- Mark passages that need revision
- Leave notes for yourself during drafting
- Track feedback from editors or beta readers
- Review AI suggestions (from the AI Line Editor)

Comments are stripped automatically when you export, so your final manuscript stays clean.

Adding a Comment

From the Toolbar

1. Select text in the editor
2. Click the Comment button in the toolbar (speech bubble icon)
3. Enter your comment text
4. Click Save

Keyboard Shortcut

1. Select text
2. Press Cmd/Ctrl+Shift+M
3. Enter your comment
4. Press Enter to save

Viewing Comments

In the Editor

Commented text appears with a yellow highlight. Hover over highlighted text to see a preview of the comment.

Click the highlighted text to open the comment popover with full details.

Comments Panel

View all comments in the current section:

1. Click the Comments icon in the inspector rail (speech bubble)
2. The Comments Panel shows all comments
3. Click any comment to jump to it in the editor

The panel shows:
- Comment text (truncated if long)
- Author (you or AI for AI-generated comments)
- Date added

Editing Comments

1. Click the highlighted text to open the comment
2. Click Edit
3. Modify the comment text
4. Click Save

Or from the Comments Panel:
1. Click the comment entry
2. Click the Edit icon
3. Make changes
4. Save

Resolving Comments

When you've addressed a comment:

1. Click the highlighted text
2. Click Resolve (or the checkmark icon)
3. The highlight is removed and text returns to normal

Resolved comments are deleted from the database.

AI Comments

When using the AI Line Editor, the AI may add comments on passages it couldn't fix directly:

• Factual questions - Is this character's age correct?
• Style choices - This passive construction may be intentional
• Continuity concerns - This contradicts earlier mention
• Suggestions - Consider expanding this scene

AI comments are marked with AI: prefix and show AI as the author.

Handling AI Comments

Review each AI comment and either:
- Make the suggested change yourself, then resolve
- Dismiss if you disagree with the suggestion
- Keep for later if you want to think about it

Comments in Export

Comments are automatically stripped when exporting to:
- EPUB
- DOCX
- PDF
- HTML
- Markdown

The highlighted text remains; only the comment markers are removed. Your readers never see your editorial notes.

Best Practices

During Drafting

• Mark sections to revisit: Expand this scene
• Note research needed: Verify historical detail
• Flag placeholders: Add character description

During Revision

• Track changes to make: Tighten dialogue
• Note consistency issues: Check timeline
• Mark for beta reader input: Does this land?

With Beta Readers

Share your project file and ask readers to add comments. Each comment shows the author, so you know who said what.

With AI Line Editor

After AI editing:
1. Review all AI comments in the Comments Panel
2. Address each one or dismiss if not applicable
3. Resolve comments as you work through them

Comments Panel Features

Navigation

Click any comment to:
- Jump to that location in the editor
- Highlight the commented text
- Open the comment for editing

Filtering

Comments show in document order. Scroll through to see all comments in sequence.

Count Badge

The Comments icon shows a badge with the number of unresolved comments in the current section.

Tips

1. Be specific - Fix pacing is less useful than Speed up the chase scene
2. Use for questions - Leave comments as questions to yourself
3. Review regularly - Don't let comments pile up unaddressed
4. Resolve as you go - Clear comments once addressed
5. Check before export - Review Comments Panel to ensure nothing was missed

Limitations

• Comments are per-section (not cross-section)
• No comment threading or replies
• No comment assignment to specific people
• Comments don't sync across devices (local to project file)
• Heavy AI edits may occasionally orphan comments (the text they were attached to changed significantly)

Keyboard Shortcuts

Action	Shortcut
Add comment	Cmd/Ctrl+Shift+M
Open Comments Panel	Click inspector icon