VSCode 확장

Remarp Slides VSCode 확장은 .md 파일과 Remarp가 생성한 HTML 파일 모두를 위한 편집 환경을 제공합니다. Visual Edit 모드로 슬라이드를 직접 드래그/리사이즈하면 소스 파일에 자동 반영됩니다.

기능

구문 하이라이팅

Remarp 전용 TextMate 문법으로 다음 요소를 하이라이팅합니다:

디렉티브: @type, @layout, @transition, @background, @class, @timing, @animation 등
블록 태그: :::notes, :::canvas, :::click, :::left, :::right, :::col, :::cell 등
클릭 속성: {.click}, {.click animation=fade-up order=2}
Canvas DSL: 도형, 위치, 스타일, 애니메이션 문법
YAML Frontmatter: 프레젠테이션 메타데이터

라이브 프리뷰

사이드 패널에서 현재 슬라이드 미리보기
사이드바 레이아웃: 오른쪽 패널에 Speaker Notes + 이슈 배지 표시
타이핑하면 자동 업데이트 (디바운스 적용)
VSCode 테마에 맞는 다크 모드
이전/다음 버튼으로 네비게이션
키보드 네비게이션 (화살표 키, Space, PageUp/Down)
커서 위치에 따라 해당 슬라이드로 동기화 (remarp.scrollSync 설정)
슬라이드 타입 렌더링: cover, compare, tabs, agenda, timeline, quiz, checklist, cards, code, steps, title, section, thankyou
@background / @badge 디렉티브: 배경 이미지와 배지 오버레이로 렌더링
Remarp가 생성한 HTML 파일 직접 프리뷰 (메타태그로 자동 인식)
HTML 파일에서도 동일한 Preview/Edit/Build 아이콘 표시

Visual Edit 모드

슬라이드 요소를 직접 드래그/리사이즈하여 편집할 수 있습니다:

활성화: Cmd+Shift+E (Mac) / Ctrl+Shift+E (Win) 또는 에디터 타이틀바의 ✏️ 아이콘
요소 드래그: 위치 변경 -> 소스 .md의 :::css 블록에 자동 반영
요소 리사이즈: 크기 조정 -> CSS에 자동 반영
Property Panel: 선택한 요소의 폰트, 색상, 여백 등 속성 편집

Canvas Editor

Canvas 슬라이드에서는 drawio 스타일의 편집 기능을 제공합니다:

SVG 오버레이: Canvas 요소 위에 편집용 hitbox 표시
박스/아이콘 드래그: :::canvas DSL의 at x,y 좌표 자동 업데이트
요소 리사이즈: size w,h 값 자동 업데이트
화살표 waypoint 편집: 경로 중간점 드래그로 꺾임 경로 조정
Step 애니메이션 컨트롤: step 순서 확인 및 테스트

CSS Writeback

Visual Edit에서 요소를 수정하면 소스 파일의 :::css 블록이 자동 업데이트됩니다:

:::css
/* Visual Edit에서 자동 생성/업데이트 */
.my-element {
  position: absolute;
  left: 120px;
  top: 80px;
  width: 200px;
}
:::

:::css 블록이 없으면 자동 생성
기존 블록이 있으면 해당 속성만 업데이트
충돌 방지를 위해 선택자 기반 병합

Canvas Writeback

Canvas 요소를 드래그하면 :::canvas DSL 블록의 좌표가 자동 업데이트됩니다:

:::canvas
box api "API Gateway" at 150,200 size 120,60 color #FF9900
:::

박스를 드래그하면 at 150,200이 새 위치로 변경됩니다.

이슈 어노테이션 & AI 리뷰

슬라이드에 개선 제안을 기록하면 Claude Code가 자동으로 수정합니다.

프리뷰 사이드바 구조:

┌──────────────────┐
│ Speaker Notes    │  ← :::notes 내용 표시
├──────────────────┤
│ Issues (배지)    │  ← <!-- issue: --> 배지 표시
├──────────────────┤
│ [입력 필드    ▶] │  ← 이슈/개선사항 입력
├──────────────────┤
│ [/slide-fix (N)] │  ← /slide-fix 안내
└──────────────────┘

사용 방법:

프리뷰 사이드바 하단의 입력 필드에 이슈나 개선사항을 입력하고 Enter
소스 .md 파일에  주석이 자동 삽입됨
슬라이드를 넘기며 각 슬라이드마다 이슈를 기록
모든 리뷰가 끝나면 Claude Code에서 /slide-fix 실행
스킬이 자동으로 이슈를 읽고 슬라이드를 수정하고 주석을 제거

이슈 포맷

이슈는  HTML 주석으로 저장되므로 마크다운 포맷에 영향을 주지 않습니다. 빌드 시에도 이슈 주석은 자동으로 제거됩니다.

HTML 파일 지원

Remarp가 생성한 HTML 파일을 자동으로 인식하여 .remarp.md와 동일한 편집 환경을 제공합니다.

인식 조건: HTML <head>에 <meta name="generator" content="remarp"> 태그가 있는 파일

지원 기능:

에디터 타이틀 바에 Preview(👁), Edit(✏️), Build(▶) 아이콘 표시
Preview: HTML 내용을 그대로 webview에서 렌더링
Visual Edit: 요소 드래그/리사이즈 시 소스 .remarp.md의 :::css 블록에 자동 반영
Build: 소스 .remarp.md를 찾아서 재빌드

소스 추적: <meta name="remarp-source" content="파일명.remarp.md"> 태그로 소스 파일을 자동 탐색합니다. HTML 파일 기준 상위 3단계까지 검색합니다.

일반 HTML 파일에는 영향 없음

Remarp 메타태그가 없는 일반 .html 파일에서는 아이콘이 표시되지 않습니다.

문서 아웃라인

탐색기 사이드바에 모든 슬라이드 트리뷰 표시
각 슬라이드: 번호, 제목 (첫 번째 헤딩), @type 표시
클릭하면 해당 슬라이드로 에디터 이동
편집 시 자동 새로고침

IntelliSense

스마트 자동완성 제공:

@ 디렉티브: 모든 지원 디렉티브와 설명
디렉티브 값: 타입별 값 (@type content|compare|canvas|quiz|...)
레이아웃 값: 모든 레이아웃 옵션
전환 효과 값: 모든 전환 효과
애니메이션 값: 12가지 애니메이션 타입
::: 블록: 모든 블록 타입과 스니펫 템플릿
{.click} 속성: 클릭 애니메이션과 order
Canvas DSL: 도형, 위치, 스타일, 애니메이션

설치 방법

VS Code Marketplace에서 설치

Extensions 뷰(Ctrl+Shift+X)에서 "Remarp Slides"를 검색하고 Install을 클릭합니다.

VSIX에서 설치 (로컬)

code --install-extension remarp-vscode-0.1.0.vsix

개발 모드

cd tools/remarp-vscode
npm install
npm run compile

그 다음 VSCode에서 F5를 눌러 Extension Development Host를 실행합니다.

사용법

.md 확장자로 파일 생성하고 frontmatter에 remarp: true 추가
Remarp 문법으로 프레젠테이션 작성
에디터 제목 표시줄의 미리보기 아이콘 클릭 (또는 "Remarp: Preview" 명령 실행)
탐색기의 아웃라인 뷰에서 슬라이드 탐색
프리뷰 사이드바에서 슬라이드별 이슈/개선사항 입력 → 자동으로 소스에 기록
모든 슬라이드 리뷰 후 Claude Code에서 /slide-fix 실행 → 자동 수정
Remarp가 생성한 .html 파일을 열면 동일한 Preview/Edit/Build 아이콘 자동 표시
Canvas 슬라이드에서 요소를 드래그하면 :::canvas DSL 좌표 자동 업데이트

키보드 단축키

슬라이드 네비게이션

단축키 (Mac)	단축키 (Win/Linux)	동작
`Cmd+Shift+Right`	`Ctrl+Shift+Right`	다음 슬라이드
`Cmd+Shift+Left`	`Ctrl+Shift+Left`	이전 슬라이드
`Cmd+Shift+E`	`Ctrl+Shift+E`	Visual Edit 모드 토글

프리뷰 내 네비게이션

단축키	동작
`←` / `→`	이전/다음 슬라이드
`Space`	다음 슬라이드
`PageUp` / `PageDown`	이전/다음 슬라이드

명령어

명령어	설명
`Remarp: Preview`	슬라이드 미리보기 패널 열기
`Remarp: Next Slide`	다음 슬라이드로 이동
`Remarp: Previous Slide`	이전 슬라이드로 이동
`Remarp: Build HTML`	HTML 빌드 (HTML 파일에서는 소스 자동 탐색)
`Remarp: Show Slide Fix Guide`	`<!-- issue: -->` 어노테이션 개수를 표시하고 `/slide-fix` 실행 안내

설정

설정	기본값	설명
`remarp.scrollSync`	`true`	에디터 커서와 프리뷰 슬라이드 동기화
`remarp.autoPreview`	`true`	Remarp 파일 열 때 자동 프리뷰
`remarp.buildOnSave`	`false`	저장 시 자동 빌드

예제

---
title: My Presentation
author: Your Name
theme: dark
---

# Welcome

This is the first slide.

---

@type compare
@layout two-column

# Comparison Slide

::: left
## Option A
- Feature 1
- Feature 2
:::

::: right
## Option B
- Feature 3
- Feature 4
:::

---

@type canvas

# Architecture

:::canvas
box "Frontend" at 100 100 size 150 80 color="#4CAF50"
box "Backend" at 100 250 size 150 80 color="#2196F3"
arrow from 175 180 to 175 250
:::

---

# Click to Reveal

- First point {.click}
- Second point {.click animation=fade-up order=2}
- Third point {.click animation=zoom-in order=3}

:::notes
Speaker notes go here - not visible during presentation
:::

요구 사항

VSCode 1.85.0 이상

알려진 제한 사항

미리보기는 단순화된 마크다운 렌더링 사용 (전체 Remarp HTML 빌더 아님)
Canvas DSL 미리보기는 소스를 <pre> 블록으로 표시 (그래픽 렌더링 아님)
일부 복잡한 중첩 블록은 하이라이팅이 완벽하지 않을 수 있음
Claude CLI 연동을 위해 claude가 PATH 또는 ~/.local/bin/에 설치되어 있어야 함

Marketplace 배포

사전 준비

# vsce (Visual Studio Code Extension CLI) 설치
npm install -g @vscode/vsce

1. Publisher 생성

https://dev.azure.com 에서 조직 생성
User Settings > Personal Access Tokens > New Token
- Scopes: Marketplace > Manage 선택
https://marketplace.visualstudio.com/manage 에서 Create publisher
- Publisher ID는 package.json의 "publisher"와 일치해야 함

2. 패키지 & 배포

cd tools/remarp-vscode

# PAT로 로그인
vsce login aws-cloud-skills

# .vsix로 패키지 (테스트용)
vsce package

# Marketplace에 배포
vsce publish

3. 버전 업데이트

# 버전 올리고 배포
vsce publish patch   # 0.1.0 → 0.1.1
vsce publish minor   # 0.1.0 → 0.2.0
vsce publish major   # 0.1.0 → 1.0.0

기능​

구문 하이라이팅​

라이브 프리뷰​

Visual Edit 모드​

Canvas Editor​

CSS Writeback​

Canvas Writeback​

이슈 어노테이션 & AI 리뷰​

HTML 파일 지원​

문서 아웃라인​

IntelliSense​

설치 방법​

VS Code Marketplace에서 설치​

VSIX에서 설치 (로컬)​

개발 모드​

사용법​

키보드 단축키​

슬라이드 네비게이션​

프리뷰 내 네비게이션​

명령어​

설정​

예제​

요구 사항​

알려진 제한 사항​

Marketplace 배포​

사전 준비​

1. Publisher 생성​

2. 패키지 & 배포​

3. 버전 업데이트​

기능