Skip to content

Latest commit

 

History

History
112 lines (89 loc) · 5.87 KB

MiaoYan.md

File metadata and controls

112 lines (89 loc) · 5.87 KB
repo url homepage starredAt createdAt updatedAt language license branch stars isPublic isTemplate isArchived isFork hasReadMe refreshedAt description tags
tw93/MiaoYan
2026-01-11T18:11:20Z
2020-04-06T10:12:33Z
2026-01-24T19:36:57Z
Swift
MIT
main
7450
true
false
false
false
true
2026-01-24T22:32:31.665Z
⛷ Lightweight Markdown app to help you write great sentences.
editor
local-first
macos
markdown
markdown-editor
notes-app
swift

English | 简体中文

MiaoYan

Lightweight Markdown note-taking app for macOS

Features

  • Fantastic: Local-first, no data collection, split editor & preview, LaTeX, Mermaid
  • Beautiful: Minimalist design, three-column layout, dark mode, distraction-free
  • Fast: Swift 6 native, better performance than Electron-based apps
  • Simple: Lightweight, keyboard shortcuts, auto-formatting

Installation & Setup

  1. Download the latest DMG package from GitHub Releases (Requires macOS 11.5+)
  2. Open DMG and drag MiaoYan.app to Applications (if DMG blocked, run xattr -cr ~/Downloads/MiaoYan.dmg)
  3. First Launch: Right-click MiaoYan.app in Applications and select "Open"
    • If still blocked: System Settings → Privacy & Security → Click "Open Anyway"
    • Or run: xattr -cr /Applications/MiaoYan.app && open /Applications/MiaoYan.app
  4. Create a MiaoYan folder in iCloud Drive or your preferred location
  5. Open MiaoYan Preferences and set the storage location to this folder
  6. Click the "New Folder" icon in the top-left corner to create document categories and start writing

Why this security prompt? MiaoYan is not notarized by Apple (requires paid developer account). The app is open source and safe to use - macOS just needs confirmation on first launch.

After installation, we recommend exploring Preferences (⌘,) to discover MiaoYan's rich customization options, including edit modes, themes, fonts, and more to create your perfect writing environment.

Split Editor & Preview Mode

Edit and preview side by side with real-time preview and 60fps bidirectional scroll sync.

Quick Toggle: Press ⌘\ to instantly toggle split view mode, or enable it in Preferences → Interface → Edit Mode → Split Mode.

Why not WYSIWYG like Typora? We prioritize pure Markdown editing experience, and implementing WYSIWYG in native Swift is overly complex with reliability concerns. Split mode maintains clean editing while providing instant visual feedback.

Split Editor & Preview Mode

Documentation

Support

  1. Cats: Tangyuan & Cola — if MiaoYan helps, treat them to canned food 🥩.
  2. If you enjoy MiaoYan, please star the project on GitHub and share it with friends who might love it too.
  3. Follow me on Twitter for the latest updates or join the Telegram group to chat with the community.

Acknowledgments

License

MIT License - Feel free to use and contribute.