Docs+ forked from Doocs。应用内及这里有完整的语法介绍和渲染效果展示。对比 Doocs,Doc+ 增加/删改了如下内容。
- 项目完全自依赖,运行时不需要外部资源。可以保持完全离线使用。
- 追求多端统一的样式效果:html、pdf(借助 pagedjs)、微信公众号、知乎文章等。
- 已打包 macos 和 windows 的桌面应用,安装即用。同时自带了本地图床服务和微信图床代理服务。请到 release 下载。
- 也可以 git clone 本仓库后按照 Doocs 介绍自行构建 Web App。但是微信图床代理服务需要自己搭建。
- 优化多种格式的统一表现。适配了微信、知乎、HTML 等多种场景。同时兼顾了各特点:比如知乎有卡片样式链接,对锚点支持也较好但知乎排版限制较多;微信虽不支持这些,但是有更丰富的文本效果;而 HTML 不受任何影响,需要保持 markdown 渲染后的完整样式。
- 注释和链接。
- 微信:脚注
[^1]
会展示在注释区,而链接[]()
会展示在链接区。 - 知乎的脚注和链接功能会遵循知乎排版展示。同时
[[](https://)]
语法复制到知乎后会展示为知乎卡片链接。 快捷键:Command + Option + K
- HTML 展示不受任何功能限制。
- 微信:脚注
- 对于加粗、斜体、代码、标题、列表这些基本 markdown 元素,微信、HTML 表现一致;知乎对 HTML 的渲染有自己的固定的要求,所以主题和配色对于知乎都失效,但基本 markdown 渲染效果还是在的。
- 支持更多对文字样式的设置。
=white:theme:12 文字内容...=
这样的语法会渲染出白色文字,主题色背景,12px
大小的一段文字。注意微信和 HTML 支持,知乎不支持。快捷键:Command + J
。 - 增加波浪下划线,样式跟随主题色。微信和 HTML支持,知乎不支持。快捷键:
Command + U
。 - 增加上标下标语法。
Docs^red:+^
上标语法,颜色设置成theme
可以跟随主题色Docs^+^
不设置颜色。H~red:2~O^
下标语法,颜色同上标。微信和 HTML支持,知乎不支持。快捷键:Command + Option + P
和Command + Option + B
。 - 增加 Admonition:
abstract/attention/bug/caution/danger/error/example/failure/hint/info/note/question/quote/success/tip/warning
。微信和 HTML 支持,知乎不支持。快捷键:Command + Option + A
。 - 删除线随主题色改变,同时加粗。
- 增加对纯英文的格式支持。
- 增加了配置图片
width
、height
、object-fit
的语法。比如下面分别会设置图片为宽度200px
高度300px
object-fitcover
;和宽度为50%
object-fitcontain
<!-- 单位为 px --> https://example.com/image.png =200x300 @cover <!-- 单位为 % --> https://example.com/image.png =50% @cotain
- 表格语法扩展。支持合并单元格等操作。详见这里
mermaid
支持设置图形大小、居中和标题。- 增加配置:
- 提供隐藏不必要功能的选项:AI助手、AI工具箱、发布按钮。
- 样式类配置:段落对齐方式、表头文字是否居中。
- 增加
gitee
图床支持。 - 增加本地图床服务
- 直接粘贴 excel 表格会自动转化为 markdown 表格,同时支持 Docs+ 扩展表格语法。也就是支持合并单元格等。
- 删除 google analytics
- 外部依赖全部本地化。
- 引用外部样式文件时导出成
HTML
和复制到微信时会丢失样式。 - 列表恢复成浏览器默认标签。否则会导致复制到知乎等地方时出现重复列表符号。
- 引用里段落间不能空行问题。
- 导出
HTML
和复制HTML
样式效果不一致 - 样式表现和语义逻辑矛盾,比如 H1 和 H2 一样大
- 更多略
- “大纲”从预览页面移动到左侧文件列表处切换显示。保证预览页面的清爽干净。
- 统一链接在新标签中打开。桌面应用中的链接也统一采用系统浏览器打开。
- 渲染引擎和 mdbook 结合
加我微信聊天: Aui_Team