지원

질문, 버그 신고, 기능 제안은 모두 support@lakesoft.jp로 편하게 보내주세요.

자주 묻는 질문

스페이스 바를 눌러도 일반 텍스트로만 표시됩니다

훑어보기 확장 프로그램은 macOS가 사용하기 전에 켜져 있어야 합니다.

  1. qlmd를 응용 프로그램 폴더로 옮기고 한 번 실행하세요
  2. 시스템 설정 → 일반 → 로그인 항목 및 확장 프로그램을 여세요
  3. 확장 프로그램 목록에서 훑어보기를 찾아 qlmd가 켜져 있는지 확인하세요
  4. 미리보기를 닫고 스페이스 바를 다시 누르세요

그래도 일반 텍스트로만 보인다면, 터미널에서 qlmanage -r을 실행해 훑어보기 생성기를 다시 불러오거나, 로그아웃 후 다시 로그인해 보세요.

qlmd가 미리보기할 수 있는 파일은 무엇인가요?

확장자가 .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 및 일반적인 별칭)가 포함되어 있습니다. 이 목록에 없는 언어는 강조 없이 일반 텍스트로 표시됩니다. 필요한 언어를 알려주시면 추가를 검토하겠습니다.

Mermaid 다이어그램이 코드로만 표시돼요

qlmd 앱의 Extensions 탭에서 Mermaid가 켜져 있는지 확인하세요. 켜져 있다면 다이어그램 소스가 올바른 Mermaid 문법이 아닐 수 있습니다 — 같은 문서를 GitHub에서 열어도 같은 문제가 나타납니다.

문서 안의 이미지가 보이지 않아요

상대 경로로 참조한 이미지는 문서가 있는 폴더를 기준으로 해석됩니다. 파일이 이동되거나 이름이 바뀌면 qlmd는 이미지 대신 대체 텍스트를 표시합니다. 원격 이미지(http:// / https://)는 불러오지 않습니다. 미리보기는 설계상 네트워크 연결이 차단되어 있습니다.

PDF나 HTML 파일로 내보내려면 어떻게 하나요?

qlmd 앱에서 문서를 여세요 — 훑어보기 미리보기 자체에는 메뉴 막대가 없습니다 — 그런 다음 File → Export as PDF… 또는 Export as HTML…을 선택하세요. PDF는 용지 크기 페이지 더미가 아니라 문서 높이만큼의 연속된 한 페이지이며, 텍스트도 선택 가능한 상태로 유지됩니다. HTML 파일은 자체 스타일과 사용된 이미지를 포함하고 있어 단독으로 어디서나 열립니다.

어떤 macOS 버전을 지원하나요?

qlmd에는 macOS 15(Sequoia) 이상이 필요합니다. 버전은 Apple 메뉴 → 이 Mac에 관하여에서 확인할 수 있습니다.

qlmd가 제 문서를 어딘가로 전송하나요?

아니요. 모든 렌더링은 Mac에서 이루어지며, 미리보기는 네트워크 연결을 열 수 없습니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

그래도 해결되지 않나요?

macOS 버전, qlmd 버전(앱의 About 탭에서 확인 가능), 그리고 가능하다면 문제가 발생한 Markdown 파일을 첨부해 support@lakesoft.jp로 이메일을 보내주세요.