질문, 버그 신고, 기능 제안은 모두 [email protected]로 편하게 보내주세요.
훑어보기 확장 프로그램은 macOS가 사용하기 전에 켜져 있어야 합니다.
그래도 일반 텍스트로만 보인다면, 터미널에서 qlmanage -r을 실행해 훑어보기 생성기를 다시 불러오거나, 로그아웃 후 다시 로그인해 보세요.
확장자가 .md, .markdown, .mdown, .mkd인 파일입니다.
설정은 다음 미리보기부터 적용됩니다. 훑어보기 창을 닫고 스페이스 바를 다시 누르세요. macOS는 파일별로 미리보기를 캐시하므로, 이미 열어본 문서가 여전히 이전 스타일로 보인다면 터미널에서 qlmanage -r cache를 실행하세요.
qlmd에는 엄선된 언어 세트(Swift, JavaScript, TypeScript, Python, Bash, JSON, YAML, XML/HTML, CSS, Go, Rust, C, Java, Ruby, SQL, diff, Markdown 및 일반적인 별칭)가 포함되어 있습니다. 이 목록에 없는 언어는 강조 없이 일반 텍스트로 표시됩니다. 필요한 언어를 알려주시면 추가를 검토하겠습니다.
qlmd 앱의 Extensions 탭에서 Mermaid가 켜져 있는지 확인하세요. 켜져 있다면 다이어그램 소스가 올바른 Mermaid 문법이 아닐 수 있습니다 — 같은 문서를 GitHub에서 열어도 같은 문제가 나타납니다.
상대 경로로 참조한 이미지는 문서가 있는 폴더를 기준으로 해석됩니다. 파일이 이동되거나 이름이 바뀌면 qlmd는 이미지 대신 대체 텍스트를 표시합니다. 원격 이미지(http:// / https://)는 불러오지 않습니다. 미리보기는 설계상 네트워크 연결이 차단되어 있습니다.
qlmd 앱에서 문서를 여세요 — 훑어보기 미리보기 자체에는 메뉴 막대가 없습니다 — 그런 다음 File → Export as PDF… 또는 Export as HTML…을 선택하세요. PDF는 용지 크기 페이지 더미가 아니라 문서 높이만큼의 연속된 한 페이지이며, 텍스트도 선택 가능한 상태로 유지됩니다. HTML 파일은 자체 스타일과 사용된 이미지를 포함하고 있어 단독으로 어디서나 열립니다.
qlmd에는 macOS 15(Sequoia) 이상이 필요합니다. 버전은 Apple 메뉴 → 이 Mac에 관하여에서 확인할 수 있습니다.
아니요. 모든 렌더링은 Mac에서 이루어지며, 미리보기는 네트워크 연결을 열 수 없습니다. 자세한 내용은 개인정보 처리방침을 참고하세요.
macOS 버전, qlmd 버전(앱의 About 탭에서 확인 가능), 그리고 가능하다면 문제가 발생한 Markdown 파일을 첨부해 [email protected]로 이메일을 보내주세요.