showmd

showmd: macOS에서 마크다운 파일을 가장 아름답게 읽는 방법

마크다운(Markdown)은 단순한 텍스트로 읽히기 위해 만들어진 것이 아닙니다. 하지만 macOS의 기본 미리보기(Quick Look) 기능을 사용하면 마크다운 파일(.md)은 온갖 특수문자가 섞인 읽기 불편한 일반 텍스트로 표시되곤 합니다. showmd는 이러한 불편함을 해결하기 위해 탄생한 macOS 전용 마크다운 미리보기 도구입니다.

What's showmd?

showmd는 macOS 사용자가 .md 파일을 별도의 에디터나 브라우저를 열지 않고도 Finder에서 즉시 렌더링된 상태로 확인할 수 있게 해주는 Quick Look 확장 프로그램입니다. 이 도구는 단순히 텍스트를 보여주는 것을 넘어, 현대적인 마크다운 사용 환경에 최적화되어 있습니다. 특히 AI 에이전트가 작성한 복잡한 구조의 마크다운이나 전문적인 기술 문서도 깔끔하게 시각화해 줍니다.

showmd는 무료이자 오픈 소스이며, 사용자의 데이터를 외부 서버로 전송하지 않는 Private by default 원칙을 고수합니다. 가볍고 빠른 성능을 자랑하며, 설치 후 스페이스바 한 번으로 마크다운의 진가를 확인할 수 있습니다.

Features (주요 기능)

showmd는 기존의 마크다운 뷰어들과 차별화되는 강력하고 독특한 기능들을 제공합니다.

1. 지능형 렌더링 및 레이아웃

• GitHub 스타일 알림: NOTE, TIP, IMPORTANT, WARNING, CAUTION 등의 콜아웃을 아이콘과 색상 테두리가 있는 GitHub 스타일로 렌더링합니다.
• YAML 프론트매터(Frontmatter) 처리: 파일 상단의 메타데이터를 접을 수 있는 테이블 형식으로 변환합니다. 기본적으로 접혀 있어 본문 가독성을 방해하지 않습니다.
• AI 에이전트 XML 태그 지원: AI가 생성하는 <instructions>, <thinking>, <example> 등의 XML 태그를 라벨이 붙은 박스 형태로 렌더링하여 구조를 명확히 보여줍니다.

2. 강력한 시각화 도구

• Mermaid 다이어그램: 코드 블록 내의 Mermaid 문법을 해석하여 순서도, 시퀀스 다이어그램 등으로 즉시 변환합니다.
• LaTeX 수식: KaTeX를 통해 인라인 및 블록 수식을 아름답게 표현합니다.
• 구문 강조(Syntax Highlighting): 190개 이상의 프로그래밍 언어에 대해 언어 인식 하이라이팅을 지원합니다.

3. macOS 네이티브 경험

• 시스템 통합: 다크 모드를 완벽히 지원하며 시스템 폰트와 이질감 없이 어우러집니다.
• 다양한 확장자 지원: .md 외에도 .mdx, .mdc, .rmd, .qmd, .markdown 등 거의 모든 마크다운 관련 확장자를 인식합니다.
• 소스 보기 및 HTML 복사: 한 번의 클릭으로 렌더링된 화면과 원본 소스 코드를 전환할 수 있으며, 내용을 HTML로 간편하게 복사할 수 있습니다.

Use Case (활용 사례)

showmd는 다음과 같은 상황에서 최고의 생산성을 발휘합니다.

• 개발자 및 엔지니어: 프로젝트의 README.md나 CHANGELOG.md를 Finder에서 빠르게 훑어볼 때.
• AI 연구자 및 사용자: AI 에이전트가 작성한 복잡한 XML 태그와 프롬프트 구조가 포함된 마크다운 파일을 구조적으로 파악해야 할 때.
• 문서 작성자: 다이어그램이나 수학 공식이 포함된 문서를 별도의 무거운 편집기를 띄우지 않고 즉시 확인하고 싶을 때.
• 협업 시: 로컬 환경의 이미지 경로가 올바르게 설정되었는지 Quick Look을 통해 즉시 확인해야 할 때.

How to Use (사용 방법)

showmd를 설치하고 활성화하는 방법은 매우 간단합니다.

1. 다운로드 및 설치: 공식 웹사이트에서 .dmg 파일을 다운로드하거나 Homebrew를 통해 설치합니다.

   brew install --cask johannesnagl/tap/showmd 명령어를 사용해 설치할 수 있습니다.

2. 앱 실행: 설치된 showmd 앱을 한 번 실행합니다.
3. 시스템 설정 활성화:
   • 시스템 설정 → 개인정보 보호 및 보안 → 확장 프로그램 → Quick Look으로 이동합니다.
   • 목록에서 showmd를 찾아 체크박스를 활성화합니다.
4. 사용 시작: Finder에서 마크다운 파일을 선택한 후 Spacebar를 누르면 즉시 아름답게 렌더링된 결과를 볼 수 있습니다.

FAQ

Q: showmd는 유료인가요? A: 아니요, showmd는 MIT 라이선스 하에 제공되는 완전 무료 오픈 소스 소프트웨어입니다. 개발자를 응원하고 싶다면 후원(Buy me a pasta)을 할 수 있습니다.

Q: 인터넷 연결이 필요한가요? A: 아니요. 모든 렌더링은 오프라인에서 로컬로 이루어집니다. 외부 서버로 파일이 업로드되지 않아 보안상 매우 안전합니다.

Q: 마크다운 파일을 편집할 수도 있나요? A: 아니요. showmd는 순수하게 '보기'를 위한 뷰어(Viewer)입니다. 편집 기능은 제공하지 않으며, 파일을 읽기 전용으로 빠르게 미리 보는 데 최적화되어 있습니다.

Q: 다른 마크다운 뷰어와 무엇이 다른가요? A: YAML 프론트매터의 테이블화, AI 에이전트 전용 XML 태그 렌더링, 그리고 Mermaid 다이어그램 지원 등을 모두 포함하면서도 무료라는 점이 가장 큰 차별점입니다.

Q: 다크 모드를 지원하나요? A: 네, macOS의 시스템 설정에 따라 자동으로 변경되며, 앱 설정에서 라이트/다크 모드를 수동으로 고정할 수도 있습니다.