MarkPane — 지원

MarkPane은 .md, .markdown, .mdown, .mkd, .txt를 포함한 읽을 수 있는 로컬 텍스트 파일을 지원합니다. 파일이 읽을 수 있는 텍스트가 아니거나 macOS가 접근 권한을 부여할 수 없으면 MarkPane이 오류를 표시합니다. 파일을 일반적인 로컬 폴더로 이동한 뒤 다시 열어 보세요.

안내가 표시되면 일반적인 로컬 폴더를 선택하세요. MarkPane은 macOS 폴더 권한을 사용해 폴더 트리를 표시하고, 그 안의 지원되는 Markdown 파일을 엽니다. 숨김 파일과 패키지 내용은 건너뛰며, Markdown이 아닌 파일은 맥락을 위해 흐리게 표시될 수 있습니다.

저장 패널이 열리면 쓰기 가능한 로컬 폴더를 선택하거나, Folder Access 창에서 쓰기 가능한 폴더 안의 Create New Markdown을 사용하세요. MarkPane은 .md, .markdown, .mdown, .mkd, .txt 파일을 만듭니다. 폴더가 읽기 전용이거나, 사용자가 허용한 폴더 접근 범위 밖에 있거나, 같은 이름의 항목이 이미 있으면 MarkPane이 오류를 표시합니다.

Folder Access 창에서 Folder Actions 메뉴 또는 폴더 컨텍스트 메뉴의 Create New Folder를 사용하세요. MarkPane은 Untitled Folder라는 쓰기 가능한 폴더 또는 다음 사용 가능한 번호가 붙은 이름의 폴더를 만든 뒤, 인라인 이름 변경을 시작합니다. 상위 폴더가 읽기 전용이거나, 사용자가 허용한 폴더 접근 범위 밖에 있거나, macOS 권한으로 차단된 경우 MarkPane이 오류를 표시합니다.

Folder Access 창의 컨텍스트 메뉴에서 Rename을 선택하세요. 이름은 비어 있을 수 없고, /를 포함할 수 없으며, 같은 폴더의 다른 항목과 같을 수 없습니다. macOS가 이동을 허용하지 않으면 일반적인 쓰기 가능한 로컬 폴더에서 다시 시도해 보세요.

Folder Access 창의 컨텍스트 메뉴에서 Delete를 선택하세요. MarkPane은 확인을 요청한 뒤 선택한 항목을 macOS 휴지통으로 이동합니다. macOS가 이동을 허용하지 않으면 일반적인 쓰기 가능한 로컬 폴더에서 다시 시도하거나 Finder에서 파일 권한을 조정하세요.

렌더링된 링크가 MarkPane이 이미 접근 권한을 가진 폴더 밖의 다른 로컬 Markdown 파일을 가리키는 경우, 안내가 표시되면 연결된 파일의 폴더를 선택하세요. 그러면 MarkPane이 연결된 문서를 탭에서 엽니다.

MarkPane은 샌드박스 앱이므로 Markdown 파일 옆에 저장된 이미지는 명시적인 폴더 접근 권한이 필요할 수 있습니다. 인라인 Allow Local Images 동작을 사용하고, 안내가 표시되면 Markdown 파일의 폴더를 선택하세요.

MarkPane은 [ ] 및 [x] 같은 작업 마커를 Markdown 파일 안에서 직접 업데이트합니다. 파일은 계속 쓰기 가능해야 하며, 렌더링된 체크박스가 소스의 작업 마커와 일치해야 합니다. 소스가 MarkPane 밖에서 변경되었다면 파일을 다시 열고 재시도하세요.

먼저 Markdown 파일을 여세요. 소스 편집기는 파일 기반 문서에서 사용할 수 있으며, 변경 사항은 해당 파일에 자동 저장됩니다.

이는 정상 동작입니다. MarkPane은 편집 중 코드 샘플이 일반 텍스트로 유지되도록 fenced 코드 블록 안에서는 Markdown 목록 이어쓰기를 적용하지 않습니다.

Find in Markdown은 제목, 표, 코드, 수식 대체 텍스트, details, 각주를 포함한 렌더링된 문서를 검색합니다. 원시 소스 텍스트 검색처럼 동작하지는 않습니다.

다이어그램이 mermaid로 라벨링된 fenced 코드 블록 안에 있는지 확인하세요. MarkPane은 flowchart, state, sequence, class, ER, XY chart Mermaid fence를 지원합니다. 다른 다이어그램 유형이나 지원되지 않는 Mermaid 문법은 렌더링되지 않을 수 있습니다.

표시 수식은 $$...$$, \[...\], fenced math 블록으로 지원됩니다. 복잡하거나 유효하지 않은 일부 TeX는 MathJax가 렌더링할 수 없는 경우 읽기 쉬운 대체 텍스트로 표시될 수 있습니다.

다른 불투명도를 선택하려면 View > Window Transparency를 사용하거나, View > Use Glass Document Surface를 전환하세요. 정확한 모양은 macOS 버전과 시스템 외관 설정에 따라 달라질 수 있습니다.

매우 큰 Markdown 파일, 복잡한 다이어그램, 큰 수식 섹션은 구문 분석과 렌더링에 시간이 조금 걸릴 수 있습니다. 문서가 느리게 느껴지면 매우 큰 생성 표를 줄이거나 파일을 더 작은 문서로 나누어 보세요.