AI용 Markdown 미리 보기에 주석을 추가하는 VS Code 플러그인
hackernews
|
|
📦 오픈소스
#ai 개발
#claude
#llm
#markdown
#review
#vs code
#피드백
원문 출처: hackernews · Genesis Park에서 요약 및 분석
요약
VS Code 플러그인 'Ace'를 사용하면 LLM이 이해하고 처리할 수 있는 구조화된 주석을 Markdown 파일에 추가할 수 있습니다. 이 도구는 토론 플래그, 삭제 표시, 편집 제안 등 4가지 유형의 피드백을 일반 텍스트 문법으로 파일에 직접 저장하여 부가 파일 없이 LLM과 협업할 수 있게 돕습니다. 플러그인은 미리 보기 모드에서 단축키를 통해 주석을 입력하고, 파일 상단에 LLM이 마커를 피드백으로 처리하도록 지시하는 헤더를 자동으로 삽입하는 기능을 제공합니다.
본문
Annotate Markdown files with structured feedback that LLMs can read and act on. LLM coding agents generate Markdown artifacts — plans, docs, code explanations. When you want to give feedback, you're stuck writing free-form text or making inline edits that lose context. There's no structured way to say "discuss this", "change that", or "remove this section" in a format the LLM can parse. Ace adds four annotation types to your Markdown files, all stored as plain-text syntax — no sidecar files, no proprietary format: | Syntax | Purpose | Preview | |---|---|---| ==highlight this== | Flag text for discussion | Yellow highlight | %%your note here%% | Leave a comment for the LLM | Hidden in preview; icon on hover | > [!EDIT] Change X to Y | Specific edit request | Styled callout block | ~~remove this~~ | Suggest deletion | Red strikethrough | Any LLM can parse these annotations directly from the .md source. Search "Ace AI Markdown Feedback" in the VS Code Extensions sidebar, or install from the Marketplace. - Open any .md file in VS Code - Side-by-side mode: Cmd+Shift+P → "Ace: Open Feedback Preview" - Preview-only mode: Right-click the file → "Open With..." → "AI Markdown Preview" - Select text in the preview and annotate: - Press H — Highlight selection - Press C — Add comment - Press E — Suggest edit - Press D — Mark for deletion - Or use the toolbar buttons at the top of the preview - Press Cmd+Z in the preview to undo- Hand the annotated .md file back to your LLM When you annotate from the preview, changes are written to the underlying .md file. To save: - Preview-only mode (custom editor): Cmd+S saves directly — works like any editor tab - Side-by-side mode: Switch to the code editor tab and Cmd+S , or close the tab and confirm save On the first annotation, Ace inserts an instruction header at the top of the file telling AI tools to respect the markers. Markdown format (default) — a visible callout that LLMs can't miss: > [!NOTE] > **Annotations present.** This file contains reviewer feedback. > `==highlights==` flag text for discussion. `%%comments%%` are inline notes. > `~~deletions~~` suggest removal. `> [!EDIT]` blocks are change requests. > Do not remove these markers — process them as feedback. HTML format — a hidden comment (previous default, less reliable with LLMs): Change the format in settings with acemd.headerFormat . The header is removed automatically when all annotations are cleared. Run Cmd+Shift+P → "Ace: Copy AI Instructions" to copy a ready-to-paste snippet explaining all annotation types. Add it to your CLAUDE.md , .cursorrules , Copilot instructions, or any AI config file to ensure your tools always respect Ace annotations. | Setting | Default | Description | |---|---|---| acemd.autoOpenPreview | true | Automatically open the Ace preview when a Markdown file becomes active | acemd.autoOpenMode | replace | How auto-open behaves: replace (preview-only) or side (side-by-side) | acemd.headerFormat | markdown | Instruction header format: markdown (visible callout) or html (hidden comment) | acemd.highlightColor | #fff3a0 | Background color for highlighted text | acemd.showAnnotationGutter | true | Show annotation markers in the gutter | Anyone using LLM coding agents (Claude Code, Codex CLI, Cursor, Copilot) who reviews Markdown output and wants a faster, more structured way to give feedback than rewriting or commenting in chat.
Genesis Park 편집팀이 AI를 활용하여 작성한 분석입니다. 원문은 출처 링크를 통해 확인할 수 있습니다.
공유