사용 안내

앱의 메뉴와 버튼 이름은 영어로 표시됩니다. 이 안내에서는 메뉴 이름을 앱에 보이는 그대로 적었습니다.

1. 설치

이 웹사이트의 다운로드에서 DMG를 무료로 내려받습니다. Mac 판은 이 웹사이트에서만 배포하며, DMG는 Apple의 공증을 받았습니다.
DMG를 열고 SSEM MarkdownEditor를 응용 프로그램 폴더로 끌어다 놓습니다. DMG 안에서 바로 실행하지 말고, 옮긴 앱을 실행하세요.
응용 프로그램 폴더나 Launchpad에서 실행합니다. 처음 실행할 때 macOS가 인터넷에서 받은 앱을 열지 물으면 열기를 누릅니다. macOS 14 Sonoma 이상이 필요합니다.
미리보기는 렌더링 라이브러리를 인터넷(jsDelivr CDN)에서 불러오므로, 처음 쓸 때는 인터넷에 연결되어 있어야 합니다.

2. 문서 만들기·열기·저장

새 문서: ⌘N. File › New from Template에서 README, Meeting Notes, Technical Documentation, Blog Post, Project Proposal, API Documentation, Changelog 템플릿으로 시작할 수도 있습니다.
열기: ⌘O, 또는 .md 파일을 창으로 끌어다 놓습니다.
최근 파일: File › Open Recent. Clear Recent Files로 목록을 비울 수 있습니다.
저장: ⌘S. 문서는 사용자가 고른 위치(또는 iCloud Drive)에 저장됩니다.

3. 보기 모드와 테마

창 오른쪽 위의 보기 버튼이나 단축키로 Editor Only(⌃⌘1), Editor and Preview(⌃⌘2), Preview Only(⌃⌘3)를 오갑니다.
분할 보기에서는 편집기와 미리보기의 스크롤 위치가 함께 움직입니다.
창 오른쪽 아래 Template 메뉴에서 미리보기 테마(GitHub Dark, GitHub Light, Notion, Paper)를 고릅니다.
편집기 색 구성은 View › Syntax Theme에서 바꿀 수 있습니다.

4. Mermaid 다이어그램

코드 블록의 언어를 mermaid로 쓰면 미리보기에 다이어그램이 그려집니다.

```mermaid
graph TD
    A[문서 열기] --> B{Mermaid 포함?}
    B -->|예| C[다이어그램 렌더링]
    B -->|아니요| D[마크다운만 렌더링]
```

5. Diagram Studio

기존 다이어그램 편집: 미리보기에서 다이어그램을 더블클릭합니다. Diagram › Edit First Diagram in Document…로 문서의 첫 다이어그램을 열 수도 있습니다.
새 다이어그램: Diagram › New Diagram in Diagram Studio…(⇧⌘D). Apply하면 편집기의 커서 위치에 코드 블록으로 들어갑니다.
비주얼 편집(순서도): 노드를 추가·이름 변경·삭제하고, 9가지 모양(Rectangle, Rounded, Stadium, Subroutine, Database, Circle, Decision, Hexagon, Flag) 중에서 고릅니다. 연결선은 6가지 스타일과 라벨을 지정할 수 있고, 배치 방향(Top → Down, Left → Right, Bottom → Up, Right → Left)을 바꿀 수 있습니다.
캔버스: 노드를 클릭해 선택합니다. Connect 모드에서는 노드 두 개를 차례로 클릭하면 연결됩니다. 확대·축소·화면에 맞추기 버튼이 있습니다.
코드 모드: 시퀀스, 클래스, 상태, ER, 간트, 파이, 마인드맵 등 모든 Mermaid 유형을 코드로 편집하며, 입력하는 동안 캔버스가 다시 그려집니다. 시작용 템플릿으로 교체할 수도 있습니다.
내보내기: PNG Image (2×), SVG Vector로 저장하거나 Copy as PNG로 클립보드에 복사합니다.
적용·취소: Apply(⌘↩)는 문서의 해당 코드 블록을 새 내용으로 바꿉니다. Cancel(esc)은 문서를 바꾸지 않고 닫습니다.

6. 수식과 코드

수식은 KaTeX로 렌더링됩니다. 인라인은 $...$ 또는 $...$, 블록은 $$...$$ 또는 \[...\]로 씁니다.
코드 블록에 언어 이름(예: swift, python, json)을 적으면 15개 이상 언어의 문법 색이 적용되고, 블록마다 복사 버튼이 나타납니다.

7. PDF 내보내기와 인쇄

File › Export as PDF…(⇧⌘E)
File › Page Setup…(⇧⌘P), File › Print…(⌘P)

8. iCloud

File › iCloud › Save to iCloud로 앱의 iCloud Drive 폴더에 저장하고, Open iCloud Folder in Finder로 그 폴더를 엽니다. iCloud Drive가 꺼져 있으면 “iCloud is not available”이 표시됩니다. 시스템 설정 › Apple 계정 › iCloud에서 iCloud Drive를 켜세요.

9. 단축키

기능	단축키
새 문서	`⌘N`
열기	`⌘O`
저장	`⌘S`
PDF로 내보내기	`⇧⌘E`
페이지 설정	`⇧⌘P`
인쇄	`⌘P`
새 다이어그램(Diagram Studio)	`⇧⌘D`
편집기만 / 분할 / 미리보기만	`⌃⌘1` / `2` / `3`
Diagram Studio 적용 / 취소	`⌘↩` / `esc`

10. 업데이트

1.0.1부터 앱이 하루에 한 번 새 버전이 있는지 확인합니다. 새 버전이 있으면 변경 내용과 함께 알림 창이 뜨고, Install Update를 누르면 내려받아 설치한 뒤 앱을 다시 시작합니다. 내려받은 파일은 Apple 공증과 회사의 전자서명(EdDSA)을 모두 확인한 뒤에만 설치됩니다.

지금 확인: 앱 메뉴 SSEM MarkdownEditor › Check for Updates…
자동 확인 끄기/켜기: 같은 메뉴의 Automatically Check for Updates
1.0을 쓰고 있다면: 1.0에는 업데이트 기능이 없으니 이번 한 번만 다운로드에서 새 DMG를 받아, 앱을 종료(⌘Q)한 뒤 응용 프로그램 폴더의 앱을 바꿔 주세요. 그다음부터는 자동으로 업데이트됩니다.

어느 방법이든 문서와 설정은 그대로 유지됩니다.

11. Windows 판

Windows 판(1.0.1)은 Microsoft Store에서 설치하는 것을 권합니다. Microsoft가 서명한 패키지라 “Windows의 PC 보호” 경고가 뜨지 않고, 새 버전이 나오면 Store가 자동으로 업데이트합니다. Store를 쓸 수 없는 PC에서는 홈페이지의 Windows 다운로드에서 ZIP을 받아 압축을 풀고 MarkMermaid.exe를 실행하면 됩니다(설치 과정 없음).

단축키: Mac의 ⌘ 대신 Ctrl을 씁니다. 새 문서 CtrlN, 새 창 CtrlShiftN, 열기 CtrlO, 저장 CtrlS, 다른 이름으로 저장 CtrlShiftS, 인쇄 CtrlP.
보기·테마: View 메뉴에서 Editor Only / Preview Only / Split View와 Dark / Light 테마를 고릅니다.
Mac 판에만 있는 기능: Diagram Studio, 수식(KaTeX), 문서 템플릿, PDF 내보내기, iCloud 저장. PDF가 필요하면 인쇄 창에서 “Microsoft Print to PDF”를 고르세요.
업데이트: Store 판은 Store가 자동으로 업데이트합니다. ZIP 판은 자동 업데이트가 없으니 새 버전 ZIP을 받아 같은 폴더에 덮어 풀면 됩니다.
삭제: Store 판은 시작 메뉴에서 앱을 마우스 오른쪽 단추로 누르고 제거를 고릅니다. ZIP 판은 압축을 푼 폴더를 지우면 됩니다. 미리보기 캐시는 %LOCALAPPDATA%\SSEM MarkdownEditor에 있으니 함께 지우세요.