showmd

showmd란?

showmd는 macOS용 무료 Quick Look 확장 프로그램으로, Finder의 기본 동작보다 Markdown 파일(.md 및 관련 확장자)을 더 읽기 쉽게 미리보기합니다. 핵심 목적은 서식과 함께 Markdown을 렌더링하면서 소스 콘텐츠에 접근할 수 있게 하는 것입니다.

Finder에서 .md 파일에 Space를 누를 때 원시 텍스트를 보여주는 대신, showmd는 Markdown을 렌더링하고 렌더/소스 토글을 제공합니다. 또한 YAML frontmatter를 접을 수 있는 메타데이터 테이블로 파싱하며, Markdown 구조에 의존하는 일반적인 문서화 및 AI 프롬프트 워크플로를 지원합니다.

주요 기능

• Finder에서 Markdown Quick Look 미리보기: Markdown 파일에 Space를 눌러 브라우저나 편집기 없이 서식된 출력을 확인하세요.
• 렌더 ↔ 소스 토글: 한 번 클릭으로 렌더된 Markdown과 원시 Markdown 소스 간 전환.
• 접을 수 있는 YAML frontmatter 메타데이터 테이블: frontmatter에서 “발견된 키”를 감지해 기본적으로 접힌 테이블로 표시.
• Markdown 파서를 통한 Markdown 기능: 테이블, 작업 목록, 취소선, 자동 링크, 각주 등 GitHub Flavored Markdown 요소 지원.
• 코드 및 특수 콘텐츠의 구문 인식 렌더링: 코드 블록은 언어 인식 하이라이팅(190+ 언어) 사용, 인라인/블록 LaTeX 수학은 KaTeX로 렌더링, Mermaid 다이어그램은 코드 블록에서 렌더링.
• AI 지향 태그 렌더링: AI 프롬프트에서 흔한 사용자 정의 XML-like 태그(예: , , )를 원시 꺾쇠 괄호 대신 레이블과 테두리가 있는 블록으로 렌더링.
• 클라우드나 백그라운드 업로드 없음: 페이지에 “No cloud. No uploads. No telemetry”라고 명시되어 있으며, 기본적으로 파일을 로컬에서 미리보기.
• Quick Look 내 인라인 이미지 처리: 상대 이미지 경로를 올바르게 해결해 로컬 스크린샷/다이어그램이 미리보기 내에 표시.

showmd 사용 방법

1. macOS용 showmd 다운로드 후 한 번 열기.
2. 시스템 환경설정 → 개인 정보 보호 및 보안 → 확장 프로그램 → Quick Look에서 showmd 활성화(페이지에서 단일 토글로 설명).
3. Finder에서 Markdown 파일 선택 후 Space 누르기 위해 showmd로 미리보기.
4. 렌더/소스 토글로 서식된 출력과 기본 Markdown 간 전환. 페이지에 HTML로 복사 옵션도 언급.

사용 사례

• Markdown으로 저장된 문서 읽기: README 파일의 서식된 제목, 목록, 링크, 테이블을 Finder를 떠나지 않고 미리보기.
• Markdown으로 작성된 AI 프롬프트/설정 파일 검사: XML-like 태그가 포함된 AI 에이전트 지시 파일을 태그를 레이블 블록으로 렌더링해 빠르게 스캔.
• 정적 사이트 콘텐츠의 YAML frontmatter 검토: 제목이나 설정 키 확인 시 frontmatter 테이블 펼치기, 캐주얼 읽기 시 접힘 유지.
• 코드, 수학, 다이어그램 포함 기술 콘텐츠 확인: 구문 하이라이트 코드 블록, LaTeX 표현, Mermaid 플로우차트를 원시 텍스트 대신 인라인 렌더링으로 확인.
• 로컬 노트/리포 문서의 상대 이미지 확인: 상대 경로로 참조된 이미지가 Quick Look 미리보기에서 올바르게 표시되는지 확인.

자주 묻는 질문

Finder에서 showmd를 어떻게 활성화하나요? showmd 다운로드 후 한 번 열고, 시스템 환경설정 → 개인 정보 보호 및 보안 → 확장 프로그램 → Quick Look으로 이동해 확장 프로그램 활성화. 첫 실행 시 macOS가 다른 앱 데이터 액세스 권한을 요청할 수 있으니 허용 클릭.

showmd가 브라우저 열 필요를 대체하나요? 페이지는 showmd를 macOS Quick Look에서 Markdown을 직접 미리보는 방법으로 설명하며, 렌더링 출력을 보려 브라우저 열 필요 없음.

렌더링 출력과 원본 Markdown 간 전환이 가능하나요? 네. showmd는 한 번 클릭으로 렌더 & 소스 토글 제공.

showmd가 YAML frontmatter를 어떻게 처리하나요? YAML frontmatter를 접을 수 있는 테이블로 파싱하며, 기본적으로 접힌 상태로 메타데이터 확인 가능.

클라우드 구성 요소가 있나요? 페이지에 “No cloud. No uploads. No telemetry”라고 명시되어 있으며, 기본적으로 로컬에서 미리보기 처리.

대안

• 전용 Markdown 뷰어/편집기에서 Markdown 파일 열기: Markdown 렌더링 및 내보내기용 앱 사용. 이러한 옵션은 종종 더 많은 편집 도구를 포함하지만, showmd는 Quick Look 미리보기 전용으로 위치합니다.
• 브라우저 기반 Markdown 렌더러 사용: 온라인 뷰어에 콘텐츠 업로드 또는 붙여넣기로 렌더링 출력 얻기. showmd와 비교해 브라우저 단계를 추가하며 파일을 엄격히 로컬에 유지하지 않을 수 있습니다.
• macOS Quick Look 기본 기능에 의존: Finder의 Space 미리보기는 원시 Markdown 소스를 표시합니다. 가장 간단하지만 테이블, 다이어그램, 수학 등 형식화된 콘텐츠에는 읽기 어려움.
• 문서/정적 사이트 툴체인으로 콘텐츠 미리보기: 로컬 개발 서버는 전체 사이트 스타일로 Markdown을 렌더링하지만, Quick Look 미리보기 워크플로보다 일반적으로 무겁습니다.