Api文档如何导出为 pdf 和 word?解决方法是借助 markdown 编辑/阅读器
关于妙言 markdown 笔记本
妙言是一款专为 mac 电脑打造的 markdown 笔记/编辑器应用,UI 布局、操作体验和字体排版非常优秀,作者是国内的一位前端开发工程师 tw93,他之前一直使用那款笔记软件的作者弃坑不维护之后,兼容性有很大的问题,后面也尝试了很多 markdown 软件,但都觉得很不习惯,就开发了妙言这个产品。
软件亮点
编辑器方面
- 原生代码编辑器的体验,作者细调了十多种 markdown 语法高亮颜色,包括文字间上下左右间距,浅色/深色模式
- 拥有VSCode 级别文档格式化,借助 prettier 将 markdown 文档自动格式化排版,空格/空行/序号一键搞定
- 原生 Swift5 开发,相比市面大部分套壳类笔记应用性能轻快不少,安装包仅 23M
- 文本文件保存:文档产物全部本地纯文本保存,可以很容易的导入或者导出
- 专注、演示、单独模式:可以 command+2 专注模式,command+4 演示模式,command+o 单独文件模式
- 全面兼容 Macos Ventura,也支持 M1 版本的通用架构模式,系统兼容性很好
功能方面
- 快速写 PPT:用 markdown 分隔符方式分页,让你半小时写完一个分享 PPT,不再纠结格式排版
- 多类插件展示:除去 GFM 中支持的各类语法,还支持 Markmap、LaTeX、Mermaid、PlantUML 展示,此外还可以嵌入各类 codepen、codeSandbox、youtube 等 iframe 区块
- 图床功能:可以在设置中配置 uPic、PicGo 、Picsee 图床,支持拖拽、复制自动上传替换地址
- 易用的 TodoList:直接使用
[]
、[x]
可以很方便写 todlist,同时可以在预览界面修改状态 - 导出 pdf 和图片:选择文档右键可很方便导出规整的 pdf 和图片,分享给你想分享的朋友
- 内联文档:可以使用
[[文章标题]]
实现妙言文档间的内联跳转,增加文档整理上的关联性
易用性方面
- 经典 3 栏布局:支持快捷键、手势快速收起和展示,此外也可以设置自己习惯的排序方式
- 默认好用的设置:默认设置即好用,可以
command+、
打开,支持设置外观、语言、字体、存储位置、图床、预览模式、换行等风格 - 简约效果展示:可去设置中设置不常用的操作按钮鼠标 hover 才显示,这样让妙言看起来更纯粹
- 设计思路:一个编辑器并不是功能越多越好,此处做了很多看不见的克制,在功能满足情况下尽量不复杂
- 默认好看:相信一个有强迫症的工程师不会喜欢比较丑的应用来当做自己每天使用的工具,妙言按照我自己的设计观念,尽可能让志同道合的朋友觉得好看。
使用体验和建议
最近因为要和第三方对接联调,需要从 api 测试工具中导出 api 文档,因为内部一些原因,没法直接分享在线的文档。于是就只能导出离线文档。不过我居然发现好几款知名的 api 测试工具都不能直接导出 pdf 或者是 word 文档,只能导出 markdown 文档。
考虑到对方不一定有 markdown 阅读器,所以还是通过 markdown 编辑器来导出 pdf 吧,于是就有了今天这篇文章,就是向大家推荐妙言这款方方面面都很优秀的 markdown 编辑器。
美丽优雅
妙言的软件 UI 采用了极简的设计风格,没有多余的东西,我最喜欢的是文件夹+文件列表+编辑器的三栏布局,也可以收起,内置了很多实用快捷键,写作高效,体验非常好。
软件默认的中文字体是我之前推荐过的免费字体霞鹜文楷体,没想到用来做笔记软件效果这么好!
安全性高
妙言可以在本地离线使用,无需联网,源文件保存在本地,很安全。而且软件完全开源,不会上传用户信息。
小巧灵活
最让我惊喜的是,和市面上很多 web 套壳方式开发的软件动辄几百 MB 不同,妙言使用 Swift5 来开发,天然拥有原生极致的性能,对多文件做了特别的性能优化,难怪运行这么流畅,一点不卡顿。
免费开源说明
妙言是一款免费开源的软件,我们可以在软件项目的 Github 主页找到下载的地方,下载教程参考我写的前一篇文章《发布在 Github / Gitee 等平台的开源软件,应该如何下载》。作者还贴心地考虑到 github 可能访问很慢,所以也提供了加速下载的链接。
妙言软件开发的源代码采用 MIT 开源协议,有能力或者有兴趣的开发者,可以下载源码来学习或者参与开发贡献,让软件变得越来越好。