| name | markers-to-notes |
| description | Export all timeline markers from DaVinci Resolve as a structured editorial notes document, grouped by color. |
| disable-model-invocation | true |
/markers-to-notes — Export Markers as Editorial Notes
Read all markers from the current timeline and produce a clean, structured document.
Workflow
- Use
resolve_get_timeline_info to get the timeline name, frame rate, and duration
- Use
resolve_list_markers to get all markers with frame, timecode, color, name, note, and custom data
- Group markers by color using this standard editorial color scheme:
| Color | Meaning |
|---|
| Red | Fix / Problem / Reshoot needed |
| Yellow | Warning / Needs attention |
| Green | Approved / Selects / Good take |
| Blue | General note / Comment |
| Purple | VFX / Graphics needed |
| Cyan | Audio note / Mix note |
| Pink | Client feedback |
| Orange | Temp / Placeholder |
-
Format as markdown with:
- Header: timeline name, date, total marker count
- Sections grouped by color (most urgent first: Red → Yellow → Purple → Cyan → Pink → Orange → Blue → Green)
- Each marker shows: timecode, name, note text
- Summary at the bottom: count per color
-
Output the markdown directly to the user. If the user specified a file path, also write it to disk.
Output Format
# Editorial Notes — [Timeline Name]
**Date:** [today] | **Markers:** [count] | **Duration:** [HH:MM:SS]
## 🔴 Fixes Required (X markers)
- **01:02:15:03** — [name] — [note]
- **01:05:22:10** — [name] — [note]
## 🟡 Needs Attention (X markers)
- **00:45:10:00** — [name] — [note]
## 🟢 Approved (X markers)
- **00:00:00:00** — [name] — [note]
---
**Summary:** X fixes, Y warnings, Z approved, W notes
Example Interactions
User: /markers-to-notes
→ Read markers, output formatted editorial notes.
User: /markers-to-notes save to ~/Desktop/notes.md
→ Same, but also write the file.
