Markdown Buddy › Mac 훑어보기로 Markdown 보기
Mac 훑어보기로 Markdown 보기
macOS는 훑어보기에서 .md 파일을 그대로의 텍스트로 보여줍니다. 우물 정 기호, 별표, 세로줄로 만든 표가 그대로 나옵니다. Markdown Buddy는 훑어보기 확장 프로그램을 설치해 대신 서식이 적용된 문서를 보여줍니다. 스페이스바 한 번이면 제목과 코드 블록까지 포함된 완성된 페이지가 나타납니다.
미리보기 켜기
- Mac App Store에서 Markdown Buddy를 설치하고 한 번 실행하세요. macOS는 확장 프로그램을 담은 앱이 한 번 실행된 뒤에야 그것을 등록합니다.
- 시스템 설정을 열고 일반, 이어서 로그인 항목 및 확장 프로그램으로 가서, 훑어보기 아래에서 Markdown Buddy가 켜져 있는지 확인하세요.
- Finder에서 .md 파일을 고르고 스페이스바를 누르세요. 그대로의 텍스트 대신 서식이 적용된 문서가 나타납니다.
미리보기에 표시되는 것
훑어보기 패널은 앱과 같은 렌더링 엔진을 쓰므로 빠지는 것이 없습니다.
- 제목, 굵게, 기울임꼴, 링크, 이미지, 인용문
- 구문 강조가 적용된 코드 블록
- 표, 작업 목록, 취소선
- Mermaid 다이어그램과 KaTeX 수식
- YAML 프런트 매터. 흩어진 텍스트가 아니라 패널로 표시
Finder의 축소판
같은 패키지가 축소판 확장 프로그램도 설치합니다. .md 파일이 빈 종이처럼 보이지 않고, 아이콘, 열, 갤러리 보기에서 렌더링된 문서의 앞부분이 보입니다. 메모가 쌓인 폴더를 한눈에 읽을 수 있게 됩니다.
미리보기가 비어 있을 때
- Markdown Buddy를 한 번 실행한 뒤 닫으세요. 한 번도 실행된 적 없는 확장 프로그램은 macOS에 등록되지 않습니다.
- 시스템 설정의 일반, 로그인 항목 및 확장 프로그램, 훑어보기 항목에서 체크되어 있는지 확인하세요.
- 터미널에서 qlmanage -r 로 훑어보기 캐시를 다시 만든 뒤 로그아웃했다가 다시 로그인하세요. macOS는 이 등록 정보를 강하게 캐시합니다.
- 파일 확장자가 정말 .md 인지 확인하세요. 일반 텍스트로 지정된 파일은 시스템 미리보기가 처리합니다.
자주 묻는 질문
Markdown Buddy를 열어 두어야 작동하나요
아닙니다. 앱을 한 번 실행한 뒤에는 훑어보기와 축소판이 알아서 동작합니다. 파일을 읽으려고 앱을 다시 열 필요는 없습니다.
어떤 macOS 버전을 지원하나요
macOS 14.0 이상. Apple 실리콘 Mac과 Intel Mac 모두에서 작동합니다.
미리보기가 제 문서를 어딘가로 보내나요
아닙니다. 렌더링은 여러분의 Mac 안, 앱 샌드박스에서 이루어집니다. Markdown Buddy는 어떤 데이터도 수집하지 않고, 파일을 보여주려고 네트워크 요청을 하지도 않습니다.
Git 저장소의 README도 미리 볼 수 있나요
네, 디스크에 있는 모든 .md 파일에 적용됩니다. 문서 안의 상대 링크와 이미지는 그 파일이 있는 폴더를 기준으로 해석됩니다.