「妙言」让写作回归纯粹

在信息爆炸的今天，大家都离不开一款又快又安全、功能齐全的笔记/文档工具。曾经，Typora 靠极简界面和强大 Markdown 支持圈了无数粉；如今它开始收费，不少人只好另觅免费、更顺手、更契合自己使用场景的 Markdown 编辑器。

项目介绍

妙言（MiaoYan）是一位全栈开发者兼产品经理做的开源小工具，免费、轻巧又放心。它把 Markdown 的干净和高效留了下来，同时在安全、离线用、代码高亮、深色主题、源文件直存、多语言、演讲及 PPT 模式上全做了加码升级。

特点

• 🏂 妙：纯本地使用、安全、语法高亮、黑暗模式、源文件保存、国际化、演示模式、PPT 模式、单独编辑模式、文档自动排版、文档导出、内部跳转、图床、LaTeX、Mermaid、PlantUML、Markmap 脑图
• 🎊 美：极简的设计风格，文件夹 + 文件列表 + 编辑器方式 3 列模式
• 🚄 快：使用 Swift5 原生开发，相比 Web 套壳方式性能体验好
• 🥛 简：很轻巧，纯编辑器输入体验，众多快捷键助你快人一步

首次使用

1. 从 GitHub Releases 中 下载 最新的 dmg 安装包，macOS Big Sur 及以上版本体验更好，如安装出现问题请参考 文档。
2. 可以在 iCloud 或根目录下创建一个 MiaoYan 的文件夹，打开妙言的设置，将默认存储地址修改成这个。
3. 点击妙言左上角新增文件夹的图标，创建好自己的文档分类文件夹，就可以开始使用了。
4. 同样假如你不习惯默认的字体，可以在设置中修改成其他的正常字体。

快捷键

窗口操作

• command + 1：收起展开目录
• command + 2：收起展开文档列表
• command + 3：切换编辑和预览
• command + 4：切换到演示模式
• command + option + m：全局唤起/隐藏妙言

文档操作

• command + n：新建文档
• command + r：重命名文档
• command + d：复制文档
• command + o：单独打开文档
• command + delete：删除文档
• command + shift + n：新建文件夹
• command + shift + l：自动排版
• command + option + r：在 Finder 中显示
• command + option + i：显示字数等文档属性
• command + option + p：启动妙言 PPT 预览

妙言PPT

PPT模式效果演示

1. 新用户默认初始化会生成模版，如果是老朋友需升级到 1.0，可以 Copy 此文件 到妙言玩一玩。
2. 执行 command + option + p 可以启动妙言 PPT 预览，也可以选中文档点击右键，选择 妙言 PPT 打开。
3. 只有在有 --- 分隔符标志的文档中，才可启用 PPT 模式，演示过程中你可以 回车键 预览演讲大纲，ESC 键可退出 PPT 模式。
4. 你可以使用 HTML 来自定义效果，更多复杂的用法可以参考 Reveal 文档。

应用场景

• 个人笔记管理：记录日常想法、学习笔记、工作备忘等。
• 技术文档编写：编写项目文档、API 说明、技术教程等。
• 演示文稿制作：支持 PPT 模式，方便制作和展示技术分享、项目汇报等演示文稿。
• 代码片段保存：保存和管理常用的代码片段，支持语法高亮。

功能模块

• 编辑器模块：提供纯编辑器输入体验，支持语法高亮、黑暗模式、源文件保存等。
• 文件管理模块：支持文件夹 + 文件列表的 3 列模式，方便文档分类和管理。
• 演示模块：支持 PPT 模式和演示模式，方便制作和展示演示文稿。
• 导出模块：支持文档导出功能，方便分享和备份。
• 图床与插件支持：集成图床功能，支持 LaTeX、Mermaid、PlantUML、Markmap 脑图等插件。

功能特点

• 纯本地使用：安全可靠，无需担心数据泄露。
• 语法高亮：支持多种编程语言的语法高亮，提升编写体验。
• 黑暗模式：适应不同环境下的使用需求。
• 源文件保存：直接保存 Markdown 源文件，方便版本控制和迁移。
• 国际化支持：提供英文、中文、日语等多种语言界面。
• 演示模式与 PPT 模式：支持一键切换演示模式和 PPT 模式，方便展示。
• 单独编辑模式：支持单独打开文档进行编辑，提升工作效率。
• 文档自动排版：一键自动排版，使文档更加整洁美观。
• 内部跳转与图床：支持文档内部跳转和图床功能，方便管理和引用图片。
• 丰富的插件支持：集成 LaTeX、Mermaid、PlantUML、Markmap 脑图等插件，满足多样化需求。
• 轻巧快捷：使用 Swift5 原生开发，性能体验优于 Web 套壳方式。
• 众多快捷键：提供大量快捷键，提升操作效率。

项目技术栈

开发语言：Swift5

依赖管理：Swift Package Manager

开发平台：macOS

功能演示

github地址：https://github.com/tw93/MiaoYan.git