MiaoYan

Active

Overview

MiaoYan is a lightweight, native Markdown note-taking app for macOS that stores notes as plain Markdown files locally for privacy.1234 It features a three-column layout with folders, note list, and editor, supporting syntax highlighting, dark mode, and advanced Markdown elements like LaTeX, Mermaid, PlantUML, and Markmap.234 Designed for programmers and writers seeking a fast, distraction-free environment without accounts or tracking.45

Key Features

  • Local-first storage - Notes saved as plain Markdown files on device, no cloud or accounts required.
  • Three-column layout - Folders, file list, and editor in minimalist design with dark mode.
  • Syntax highlighting - Real-time preview with bidirectional scroll sync.
  • Presentation/PPT modes - Convert Markdown to slide-style views.
  • Diagram support - LaTeX math, Mermaid, PlantUML, Markmap rendering.
  • Image upload - Drag-and-drop with uPic, PicGo, Picsee hosting integration.
  • TodoList - Use [ ] and [x] syntax, editable in preview.
  • Auto-typesetting - Automatic document formatting and internal links.
  • Keyboard shortcuts - Fast editing with native Swift performance.

Pricing

PlanPriceIncludes
Free DMGFreeFull features via GitHub releases.
Mac App Store¥88.00One-time purchase with App Store updates and family sharing.

Platforms & Requirements

Runs on macOS 11.5 or later (some sources note macOS 11).135 Native Swift app, lightweight at 16.3 MB, no support for other platforms like iOS, Windows, or web.5

Integrations & Ecosystem

  • uPic image hosting
  • PicGo image hosting
  • Picsee image hosting
  • iCloud Drive storage
  • Command-line interface
  • Markdown file import/export

Alternatives

AppDifference
TyporaElectron-based cross-platform editor with live preview, less native macOS feel.
ObsidianPlugin-heavy knowledge base with graph view, more complex than MiaoYan's simple notes.
BeariCloud-synced Markdown app with iOS support, proprietary format unlike MiaoYan's plain files.
NotionAll-in-one workspace with databases, heavier and cloud-dependent vs local-first.

Reputation

MiaoYan is praised for its native Swift performance, privacy-focused local storage, and engineer-friendly features like diagram support and image hosting.346 Users appreciate the lightweight design and speed over Electron apps, with positive mentions for Chinese/English typography.24 Some note it's Mac-only, limiting cross-platform use, and App Store version requires payment despite free alternatives.5

Sources (9)
  1. https://formulae.brew.sh/cask/miaoyan
  2. https://miaoyan.macupdate.com
  3. https://github.com/tw93/MiaoYan
  4. https://sourceforge.net/projects/miaoyan.mirror/
  5. https://apps.apple.com/cn/app/miaoyan/id6759252269
  6. https://tw93.fun/en/2022-09-09/miaoyan.html
  7. https://sourceforge.net/projects/miaoyan.mirror/files/V2.7.0/
  8. https://github.com/tw93/miaoyan
  9. https://miaoyan.app