https://miaoyan.app/blog/ Guides to writing in Markdown and keeping Markdown notes as local files on Mac, iPhone and iPad. en https://miaoyan.app/blog/markdown-editor-for-mac/ https://miaoyan.app/blog/markdown-editor-for-mac/ Mon, 19 Oct 2026 01:00:00 +0000 What to check in a Mac Markdown editor: plain files, WYSIWYG or split preview, math, sync and speed, with Typora, Obsidian, VS Code and MiaoYan compared. https://miaoyan.app/blog/markdown-cheat-sheet/ https://miaoyan.app/blog/markdown-cheat-sheet/ Mon, 19 Oct 2026 01:00:00 +0000 The Markdown syntax you actually use, with examples, what CommonMark and GFM each define, and what MiaoYan renders on top. https://miaoyan.app/blog/latex-math-in-markdown/ https://miaoyan.app/blog/latex-math-in-markdown/ Mon, 19 Oct 2026 01:00:00 +0000 Write inline and block math in Markdown, use common LaTeX constructs, avoid dollar and underscore pitfalls, and see how MiaoYan renders KaTeX. https://miaoyan.app/blog/mermaid-diagrams-in-markdown/ https://miaoyan.app/blog/mermaid-diagrams-in-markdown/ Mon, 19 Oct 2026 01:00:00 +0000 Draw flowcharts, sequence and Gantt diagrams with fenced Mermaid blocks, plus PlantUML and Markmap, and what MiaoYan renders offline. https://miaoyan.app/blog/markdown-to-slides/ https://miaoyan.app/blog/markdown-to-slides/ Mon, 19 Oct 2026 01:00:00 +0000 Turn a Markdown note into a slide deck with --- separators, configure reveal.js options, and compare Marp, reveal.js and Slidev. https://miaoyan.app/blog/typora-alternative-mac/ https://miaoyan.app/blog/typora-alternative-mac/ Mon, 19 Oct 2026 01:00:00 +0000 Why people leave Typora, WYSIWYG versus split preview, what carries over (files, math, images) and where each app is stronger. https://miaoyan.app/blog/local-first-markdown-notes/ https://miaoyan.app/blog/local-first-markdown-notes/ Mon, 19 Oct 2026 01:00:00 +0000 Why plain Markdown files in your own folder beat a locked-in notes app, what it costs, and how MiaoYan reads the folder you choose. https://miaoyan.app/blog/sync-markdown-notes-across-devices/ https://miaoyan.app/blog/sync-markdown-notes-across-devices/ Mon, 19 Oct 2026 01:00:00 +0000 Use iCloud Drive, Nutstore, Dropbox or git to sync a Markdown notes folder, set MiaoYan's Note Location, and avoid conflict copies. https://miaoyan.app/blog/wikilinks-and-backlinks/ https://miaoyan.app/blog/wikilinks-and-backlinks/ Mon, 19 Oct 2026 01:00:00 +0000 How [[wikilinks]] differ from normal Markdown links, what MiaoYan supports, how backlinks are built, and the portability trade-offs. https://miaoyan.app/blog/markdown-notes-from-terminal/ https://miaoyan.app/blog/markdown-notes-from-terminal/ Mon, 19 Oct 2026 01:00:00 +0000 Install the miao CLI, learn open, new, search, list and cat, script them, and use them with AI coding agents and the MiaoYan skill. https://miaoyan.app/blog/obsidian-alternative-mac/ https://miaoyan.app/blog/obsidian-alternative-mac/ Mon, 19 Oct 2026 01:00:00 +0000 What MiaoYan has and leaves out compared with Obsidian, how to open a vault, and which syntax carries over. https://miaoyan.app/blog/markdown-note-version-history/ https://miaoyan.app/blog/markdown-note-version-history/ Mon, 19 Oct 2026 01:00:00 +0000 How MiaoYan saves and restores note versions, where they live, their limits, and how Time Machine and git cover what it does not.