콘텐츠로 이동

VS Code에서 Markdown 미리보기

.md 파일을 연 상태에서 Cmd+Shift+V(Windows·Linux는 Ctrl+Shift+V)를 누르면 렌더링된 미리보기가 새 탭에 열립니다.

Preview in a tab ⌘⇧V / Ctrl+Shift+V
Side-by-side ⌘K V / Ctrl+K V

Cmd+K 다음 V(Ctrl+K V)를 누르면 편집기 옆에 미리보기가 열립니다. 입력에 맞춰 스크롤이 동기화됩니다.

VS Code는 기본으로 Markdown을 렌더링합니다. 기본 미리보기를 위해 확장을 설치할 필요는 없습니다. PDF 내보내기나 특별한 다이어그램 문법이 필요하면 해당 기능을 명시적으로 지원하는 확장을 따로 확인하세요.

파일 확장자가 .md인지 확인하고 편집기의 언어 모드가 Markdown으로 설정되어 있는지 보세요. 명령 팔레트를 열어 Markdown: Open Preview를 실행하면 단축키 문제와 파일 인식 문제를 구분할 수 있습니다.

명령 팔레트 Cmd+Shift+P / Ctrl+Shift+P
미리보기 명령 Markdown: Open Preview
옆으로 여는 명령 Markdown: Open Preview to the Side

다른 문서가 미리보기에 남아 있다면 미리보기 탭을 선택하고 Markdown: Toggle Preview Locking을 확인하세요. 표가 깨질 때는 표의 구분 행과 열 수를, Enter를 눌러도 줄이 나뉘지 않으면 Markdown 줄바꿈을 확인할 수 있습니다.

외부 이미지나 스크립트가 차단되면 미리보기 보안 설정을 확인하세요. 출처를 모르는 문서를 보기 위해 보호 기능을 끄지 말고, 신뢰할 수 있는 로컬 이미지와 기본 문법으로 먼저 확인하세요.