Ace: AI Markdown Feedback

Give your AI feedback it can read.

A VS Code extension that lets you annotate Markdown the way you would mark up a document: highlight, comment, request an edit, strike a line. The markers are plain text, so any LLM can parse them straight from the file.

VS Code extension Free · MIT licensed Works with Claude, Codex, any LLM
› ext install AlfredNaayem.ai-markdown-feedback
Install from Marketplace View on GitHub

Already in VS Code? Open the Extensions panel and search Ace AI Markdown Feedback.

The agent writes Markdown

Plans, docs, explanations. Artifacts you need to react to.

Free-form replies lose context

"Change the third bullet" leaves the agent guessing which one.

Annotate in place instead

Mark the exact text. The agent reads the markers and acts.

Four markers

One keystroke each. Plain text underneath.

Select text in the preview and press a key. The marker is written into the Markdown source, so there are no sidecar files and nothing proprietary.

==highlight this==

Highlight

Flag a passage for discussion without saying what is wrong yet. Press H.

In previewThe retry logic doubles the delay every attempt until it gives up.
%%your note here%%

Comment

Leave an inline note for the LLM. Hidden in the reading view, visible in the source. Press C.

In previewShip the beta Friday. note
> [!EDIT] Change X to Y

Edit request

Ask for a specific change, rendered as a callout so it stands out. Press E.

In previewEDIT. Make this section a numbered list instead of prose.
~~remove this~~

Deletion

Suggest cutting a line or section. Shows as a strikethrough. Press D.

In previewKeep the summary. Drop the second caveat paragraph.
In the editor

Annotate on the right. Source updates on the left.

Ace AI Markdown Feedback in VS Code: the Markdown source on the left, an annotation preview with a highlight and a comment on the right.
The loop

Review, hand back, repeat.

1

Open the preview

Cmd+Shift+P then "Ace: Open Feedback Preview", side by side with your Markdown.

2

Select and mark

Highlight text, then H, C, E, or D. The marker writes into the file.

3

Save

Cmd+S. Ace adds a one-time header telling AI tools to respect the markers.

4

Hand it back

Give the annotated .md to Claude, Codex, or any agent. It reads the feedback and acts.

Install

Two ways in.

1

From the sidebar

Open the Extensions view in VS Code and search Ace AI Markdown Feedback. Click Install.

2

From the command line

code --install-extension AlfredNaayem.ai-markdown-feedback
3

Open any Markdown file

Works with Cursor, Windsurf, and VSCodium too, since they share the VS Code extension format.

Mark it up. Hand it back.

Free, MIT licensed, and the markers stay in plain text you can read without the extension.

Install from Marketplace

Open source on GitHub. Star it, file an issue, or send a pull request →

Plain-text markers No sidecar files Any LLM can parse it