# MiaoYan (open-source notes and writing app)

> MiaoYan is a free, open-source notes and writing app for macOS. Lightweight Markdown app to help you write great sentences. It has 8,669 GitHub stars and is released under the MIT license. Its source code is on GitHub at tw93/MiaoYan.

Lightweight Markdown note-taking app for macOS Homebrew and GitHub Releases install this open-source app, which now receives fixes only. The App Store edition is developed separately, includes the iPhone and iPad app, and is where new features land. After installing, create a MiaoYan folder in iCloud Drive, a desktop cloud-drive folder, or your preferred location, open Preferences (⌘,), and set the storage path.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/tw93/MiaoYan |
| Platforms | macOS |
| Interface | desktop GUI |
| GitHub stars | 8,669 |
| License | MIT (open source) |
| Replaces | n/a |
| Language | Swift |
| Website | https://miaoyan.app |
| Official | no |
| Category | Notes & writing |
| Latest release | V4.5.0 (Sep 25, 2026) |
| Last commit | Oct 7, 2026 |

## Install

### Homebrew (macOS)

```sh
brew install --cask miaoyan
```

Package page: https://formulae.brew.sh/cask/miaoyan

## Similar desktop apps

- [AppFlowy](https://appsgit.com/desktop-apps/appflowy): Bring projects, wikis, and teams together with AI. (77,181 stars, AGPL-3.0, official)
- [AFFiNE](https://appsgit.com/desktop-apps/affine): There can be more than Notion and Miro. AFFiNE(pronounced [ə‘fain]) is a next-gen knowledge base that brings planning, sorting and creating all together. (73,298 stars, MIT / AFFiNE EE License, official)
- [Marktext](https://appsgit.com/desktop-apps/marktext): A simple and elegant markdown editor, available for Linux, macOS and Windows. (62,228 stars, MIT)
- [Joplin](https://appsgit.com/desktop-apps/joplin): Joplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS. (56,630 stars, AGPL-3.0-or-later, official)
- [SiYuan](https://appsgit.com/desktop-apps/siyuan): An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间，让人与智能体在此协作. (46,669 stars, AGPL-3.0, official)
- [Logseq](https://appsgit.com/desktop-apps/logseq): A privacy-first, open-source platform for knowledge management and collaboration. (45,173 stars, AGPL-3.0, official)

---

Canonical page: https://appsgit.com/desktop-apps/miaoyan
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.