1Markdown 转换器
Markdown 转换器是以 Marked 为基础进行的二次开发, 主要的流程如下图所示.

1.1重构 marked
2019-10-06 (星期日), 基于 marked v0.7.0 (git commit: 26ae990) 版本进行重构, 主要改动如下:
- 增加转换时的异常捕获
- 增加异常发生的时间
- 选项设置, 主要将
gfm,smartypants这两个设置为 true. 增加wxFmt选项, 为了导出微信公众号格式. - 文本对齐功能
- aligntext rule 需要优化
- 展示拼音功能
- 标题样式主题
- 快捷键插入图片 F6
- 微信模式下, OSS 返回限制大小的图片
x-oss-process=style/wx- 压缩命令需要更健壮一些
- 增加更多不同样式的 blockquote, TIP, WARN, DANGER
- 支持 emoji 表情
- 自动格式化, 包括中英文空白, 行末空白, 标点符号使用 (全角/半角, 引号)
- 数学公式, 转图片
- Markdown 语法检查
- 拼写检查
- 字数统计
- 目录 TOC
- 超链接转脚注功能
- 左侧与右侧视图同步滚动,进一步提升使用体验, 参考 https://github.com/hadeshe93/irm-markdowner
1.2数学公式
数学公式显示方案, 采用更高效的 katex, 需要在上面的六个模块中分别增加相关代码.
行内公式用单个美元符号, 行间公式用两个美元符号括起来. 注意: 需要在 text inline rule 中, 增加 $ 字符.
行内公式也是可以的哦! 支持宏定义. 比如说, 设 , 那么 .
\int_a^bf(x){\rm d}x=F(b)-F(a)\tag1 \sum_{i=1}^ni^2=\frac16n(n-1)(n-2)\tag2
1.3代码高亮
代码自动高亮, 采用 highlight.js 解决方案.
for(int i=0; i<n; i++) {
sum += i;
}
2Markdown 编辑器
2.1文本编辑器
文本编辑器, 选用 Ace 的 ace-builds.
- 演示文件:
kitchen-sink.html - 演示文件:
ace-builds/textarea/editor.html - 快捷键的定义和管理全在
lib/ace/commands文件夹中.
2.2全屏模式
全屏编辑更酸爽, 好好写博客, 多沉淀内容.
- 全屏也支持弹出对话框
2.3快捷键
F1, 调出命令面板Command-,, 查看配置菜单Command-F, 查找Command-Option-F, 查找替换Ctrl-Alt-G, 查找全部, 并进入多行编辑模式Command-D, 删除当前行Command-Shift-D, 重复当前行Ctrl-U, 英文字母转大写Ctrl-Shift-U, 英文字母转小写
3导出微信公众号网页
方案调研
- markeditor 1.x 版本, 付费版提供了导出功能. 缺点: 不方便定制, 而且 Markdown 文本编辑体验一般, 当初购买的原因就是为了公众号排版.
- https://github.com/lyricat/wechat-format, 作者称用三小时打造的工具, 详情参见花三小时写这个工具,只为一分钟拯救公众号排版. 本质是用浏览器复制功能, 但需要将部分样式改为 style.
体验或直接使用, 可以用 WeChat Format 在线版.
- 仅源码需要读取一遍
- 嫌微信公众号排版太丑?这里让你一步到位, 在线体验地址: https://md.ironmaxi.com, 阅读源码 https://github.com/hadeshe93/irm-markdowner
- 大神小胡子哥的 https://github.com/barretlee/online-markdown
- 阅读源码: markdown-nice, 线上体验地址: https://mdnice.com
4ace 笔记
ace 是 AWS Cloud9 一款用于编写、运行和调试代码的云 IDE 背后的代码编辑器, 体验地址 https://c9.github.io/core
const editor = ace.edit(el);
const session = editor.getSession();
const selection = editor.getSelection();
editor.setTheme()
editor.setKeyboardHandler()
editor.getSession().setMode()
editor.setValue()
editor.clearSelection()
editor.destroy();
editor.container.remove();
- 扩展 ext
- 代码片段 snippets
- 代码片段统一用
sp结尾, 因此输入sp即可看到所有代码片段
- 代码片段统一用
- 主题 theme
4.1待办
参考文献
- GitHub 上基于 ace 的开源 Markdown 编辑器
- awesome-web-editor
- ACE 编辑器, 使用简单, 功能强大. 全功能 demo, Wiki
- Cloud9 IDE, 代码可供参考
- vue-markdown
- Vue写一个Markdown编辑器
- Markdown 测试样例
- Cmd Markdown