Seafile Markdown 编辑器介绍 -- 更好用的 Markdown 所见即所得编辑器

Markdown 是一种简单易用的标记语法，它可以使普通文本内容具有一定的格式，在软件文档中被广泛采用。Seafile 从 6.3 版本开始加入了所见即所得的 Markdown 编辑器，又在 7.0 版本对它进行了大幅的改进，并把它作为 Seafile 知识管理功能的基础，可以使用 Markdown 语法编辑 Wiki 文档内容。这里我们对其他的 Markdown 编辑方案进行一下对比，然后再对 Seafile 的 Markdown 编辑器功能进行介绍。

Markdown 编辑器对比

与在线 Markdown 编辑器对比

大部分在线的 Markdown 编辑器如下图所示，采用的是左边编辑右边预览的写作方式。在编辑表格和图片等复杂格式的时候不够方便。由于右边显示的只是预览效果，并不允许直接针对所见来编辑，只能编辑左边对应的 Markdown 语法来间接修改。尤其对表格编辑，无法直接添加列、删除列、粘贴复制单元格。

在Seafile Markdown编辑器中，我们提供的是“所见即所得”的编辑方式，将编辑和预览融为一体，简单直观。无需编辑Markdown语法，通过界面正上方的按钮即可轻松插入图片、表格、链接、列表等各种文档格式。对于图片和表格的编辑也更加简单，上传的图片会作为一个文件保存在Seafile里面，可以针对图片显示大小进行调整。表格可以自由增减行和列。

与桌面版Markdown编辑器对比

目前也有一些优秀的桌面版的所见即所得的 Markdown 编辑器，比如 Typora。他们在使用上主要有两点不方便的地方：

• 插入图片时仅允许输入网络链接，本地的图片需要先上传到网络中才能插入。
• 发布文档的时候，需要寻到第三方发布平台把文件上传上去。

针对以上问题，Seafile Markdown编辑器提供了更加灵活的方案：

• 支持直接插入本地图片，并将图片作为一个文件保存在Seafile中。
• Seafile本身就是最便捷的软件文档发布平台。你可以在资料库中编辑多个Markdown文件，然后将资料库以维基的形式来对外发布，省去现有流程中从github 下载、push、再发布到第三方文档平台的麻烦。

Seafile Markdown 编辑器功能介绍

Seafile Markdown 编辑器支持在浏览器里面以所见即所得的方式编辑 Markdown 文件，具有以下特点：

• 像编辑 word 文件一样编辑 Markdown 文件，简单直观。
• 轻松插入图片、表格、链接、列表。
• 图片插入: 你可以直接在文档中上传一个图片，还可以调整图片的显示大小，图片会作为一个文件保存在 Seafile 里面。你也可以通过 Ctrl-V 来黏贴一个图片截图。
• 表格编辑: 支持增删行和列，支持连续单元格的复制和拷贝。
• 文件历史和 Diff
• 文档格式改进建议

插入图片、文件

Seafile Markdown编辑器支持快速插入图片和文档，对于图片提供了3种插入模式：

• 插入网络图片：提供一个网络链接来插入图片
• 插入资料库图片：从Seafile已有资料库中选择插入图片
• 上传本地图片：从本地目录上传图片，图片会作为一个文件保存在Seafile中

还可以将资料库中的文件作为一个链接插入，当点击这个链接时可以很方便地跳转到该文件进行查看。

文件历史和 Diff

当多人在线协作同一个文档时，我们需要知道其他人对文档做了哪些修改。Markdown文档的历史将自动写入到数据库中，使用户可以快速访问文件的历史版本。

Markdown文档支持Diff的功能，可以对修改前后两个版本的内容进行比较。在浏览历史版本时，有修改的地方将会用红色和绿色字体突出显示。

文档格式改进建议

在我们编辑Markdown文档时不可避免地会出现一些格式问题，如果没有提示自己也很难发现，就会影响文档的规范性。为了使文档更规范，Seafile Markdown编辑器会自动检查文档格式，并对常见的格式问题进行自动提示。目前支持的内容包括：

• 缺少某一级标题
• 标题以冒号结尾
• 标题层级不连贯

如下图所示，打开文档右侧隐藏栏并点击中间蓝框中的按钮，就可以查看编辑器自动给出的修改提示。在后续的版本中我们还会增加更多的智能提示，来更好的帮用户规范Markdown文档。

Seafile 7.0 版本现在已经发布到了 Seafile 的官网（https://www.seafile.com/download/），感兴趣的用户可以去下载使用，欢迎大家反馈意见！