English | 中文

MiaoYan

Lightweight Markdown app to help you write great sentences.

Features

• 🏂 Fantastic: Local use, security, syntax highlighting, dark mode, source file saving, international, presentation mode, PPT Mode, single edit mode, export file, internal jump, document auto typesetting, picture upload, LaTeX, Mermaid, PlantUML、Markmap.
• 🎊 Beauty: Minimalist design style, folder + file list + editor 3 column mode.
• 🚄‍ Fast: Using Swift5 native development, the performance experience is much better compared to the Web.
• 🥛 Simple: Very light, pure editor input experience, many shortcut keys to help you fast.

First Use

1. Download the latest dmg installation package from GitHub Releases and double-click to install it, macOS Big Sur and above have a better experience. Also support brew install miaoyan -- cask installation.
2. You can create a MiaoYan folder in iCloud or root directory, open MiaoYan's settings,change the default storage address to this.
3. Click icon of the new folder in the upper left corner of MiaoYan, create your own document category folder, and you can start using it.
4. Similarly, if you are not used to the default font, you can change it to other normal fonts in the settings.

Shortcut Keys

Window Operations

• command + 1: Collapse expand folder list
• command + 2: Expand the list of documents
• command + 3: Switching between edit and preview states
• command + 4: Switching between edit and presentation states
• command + option + m: Global active/hide MiaoYan

File Operations

• command + n：New document
• command + r：Rename document
• command + d：Copy document
• command + o：Single open document separately
• command + delete：Delete document
• command + shift + n：New folder
• command + shift + l：Auto typesetting
• command + option + r：Displaying document in Finder
• command + option + i：Display document attributes such as word count
• command + option + p：Launch MiaoYan PPT preview.

🏂 There are also many other shortcuts 👆🏻 👇🏻 👈🏻 👉🏻 waiting for you to find if you like to toss and turn~

MiaoYan PPT

1. The default initialization of new friends will generate templates. If you are an old friend, You need to upgrade to 1.0 then try copy this file to MiaoYan.
2. Execute command + option + p to start MiaoYan PPT preview. At the same time, you can also select the document, right-click and select 'MiaoYan PPT' to open it.
3. PPT mode can be enabled only in documents marked with --- separator. During the presentation, You can preview the outline of the speech with Enter Key and exit ppt mode with ESC Key.
4. You can use HTML to customize the effect. For more complex usage, Please refer to reveal Documentation.

Why do this

• I have tried many note-taking applications before, such as WizNote, Ulysses, Quiver, MWeb, Bear, Typora, for various reasons, I did not find a conventional Markdown application, so I had the idea of doing MiaoYan.
• My job is front-end development, but also can develop iOS App, love to toss new things, so develop MiaoYan as a fun leisure.

Support

• I have two cats, one is called TangYuan, and one is called Coke, If you think MiaoYan makes your life better, you can give my cats feed canned food 🥩🍤.
• If you like MiaoYan, you can star it in Github. We are more welcome to recommend MiaoYan to your like-minded friends.
• You can follow my Twitter to get the latest news of MiaoYan, or join Telegram chat group.

Thanks

• KristopherGBaker/libcmark_gfm: Swift Compatible framework for cmark-gfm.
• raspu/Highlightr: Syntax highlighting capability.
• glushchenko/fsnotes: MiaoYan has part of the framework code from this project.
• lxgw/LxgwWenKai: A beautiful open source chinese font, MiaoYan has made it the default font.
• michaelhenry/Prettier.swift：MiaoYan document auto typesetting is from Prettier.
• hakimel/reveal.js：An open source HTML presentation framework.
• Thanks to Vercel for providing static rendering capability to MiaoYan.
  

License

• Follow the MIT License.
• Please feel free to enjoy and participate in open source.