MiaoYan
집중을 방해하지 않는 깔끔한 macOS 마크다운 노트 앱
English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français
## 특징
- **로컬 우선**: 노트는 사용자 Mac에만 저장되며, 클라우드 전송이나 추적이 없습니다
- **3단 집중 뷰**: 다크 모드를 지원하는 간결한 인터페이스로 플러그인 스트레스가 없습니다
- **네이티브 성능**: 웹 래퍼보다 가볍고 빠른 Swift 네이티브 앱으로 부드러운 미리보기를 제공합니다
- **풍부한 기능**: 양방향 링크, 수식, 차트, 슬라이드 발표까지 완벽 지원
## 설치
1. **Mac App Store** (유료, 자동 업데이트, iPhone 및 iPad 앱 포함):
2. **Homebrew**:
```bash
brew install --cask miaoyan
```
3. **GitHub Releases**: [GitHub Releases](https://github.com/tw93/MiaoYan/releases/latest)에서 최신 DMG 다운로드 (macOS 12.0+)
Homebrew 및 GitHub Releases는 버그 수정만 제공되는 오픈소스 버전을 설치합니다. iPhone 및 iPad 앱을 포함한 신기능 버전은 Mac App Store 에디션으로 별도 개발됩니다. 설치 후 iCloud Drive나 로컬 동기화 폴더에 `MiaoYan` 폴더를 생성하고 환경설정(⌘,)에서 저장 위치를 지정하세요.
## Nutstore 및 기타 클라우드 드라이브 동기화
MiaoYan은 로컬 우선 앱으로 WebDAV나 클라우드 계정에 직접 로그인하지 않습니다. 지정된 마크다운 폴더만 읽고 쓰며, 기기 간 동기화는 iCloud Drive, Nutstore, Dropbox 등의 클라우드 클라이언트가 담당합니다.
- **Mac**: 클라우드 동기화 폴더 안에 `MiaoYan` 폴더를 만들고 환경설정에서 해당 경로를 저장 위치로 지정
- **iPhone**: 시스템 파일 앱에서 동일한 클라우드 드라이브 폴더 선택. 쓰기 가능한 폴더를 지원하지 않는 경우 iCloud Drive를 사용하거나 해당 앱에서 오프라인 사용 가능으로 설정 후 선택
- **경로 확인**: MiaoYan은 폴더 전환 전 읽기/쓰기 권한을 확인합니다. 접근할 수 없는 경우 기존 경로를 유지하며 오류를 앱 자체 동기화 실패로 표시하지 않습니다
## CLI 도구
터미널에서 노트를 빠르게 조작할 수 있는 커맨드라인 도구를 제공합니다.
```bash
# 설치
curl -fsSL https://raw.githubusercontent.com/tw93/MiaoYan/main/scripts/install.sh | bash
# 사용법
miao open <제목|경로> # 노트 또는 폴더 열기
miao new <제목> [내용] # 새 노트 생성
miao search <검색어> # 터미널에서 노트 검색
miao list [folder] # 최상위 폴더 또는 폴더 내 마크다운 목록
miao cat <제목|경로> # 노트 내용 출력
miao update # CLI 업데이트
```
## 분할 편집 및 미리보기 모드
편집 영역과 미리보기를 나란히 배치하고 60fps 양방향 스크롤 동기화로 실시간 미리보기를 제공합니다.
**빠른 전환**: `⌘\` 키로 분할 모드를 전환하거나 환경설정 → 인터페이스 → 편집 모드 → 분할 모드에서 활성화할 수 있습니다.
Typora 스타일의 실시간 인라인 렌더링을 하지 않는 이유: 순수한 마크다운 편집이 핵심 가치이기 때문입니다. Swift 기반의 네이티브 WYSIWYG는 무겁고 불안정해지기 쉽습니다. 분할 모드는 작성에 대한 집중을 유지하면서 매끄러운 실시간 시각적 피드백을 제공합니다.
## 문서
- [마크다운 문법 가이드](Resources/Initial/MiaoYan%20Markdown%20Syntax%20Guide.md) - 고급 기능을 포함한 전체 문법 레퍼런스
- [PPT 프레젠테이션 모드](Resources/Initial/MiaoYan%20PPT.md) - `---` 슬라이드 구분선을 활용한 발표 가이드
- [MiaoYan Agent Skill](skills/miaoyan) - 에이전트에게 MiaoYan 문법, 첨부파일, PPT 및 CLI 워크플로 학습
`npx skills add tw93/MiaoYan/skills/miaoyan -g` 명령어로 공식 Skill을 설치할 수 있습니다.
## 후원
- 개발자를 지원하는 가장 직접적인 방법은 유료 Mac 정리 앱인 [Mole for Mac](https://mole.fit)을 이용해 주시는 것입니다
- MiaoYan이 유용했다면 Star를 누르거나, [공유](https://twitter.com/intent/tweet?url=https://github.com/tw93/MiaoYan&text=MiaoYan%20-%20A%20fast%2C%20elegant%20Markdown%20editor%20for%20Mac.)하거나, 이슈 및 PR을 남겨주세요
- 탕위안(TangYuan)과 콜라(Coke)라는 두 마리의 고양이를 키우고 있습니다. MiaoYan이 즐거움을 주었다면 캔 간식 🥩을 후원해 주세요
