一款开源的Markdown转富文本编辑器的实现原理剖析

笔者平时写文章使用的都是Markdown，但是发布的时候就会遇到一些平台不支持Markdown的情况，重排是不可能重排的，所以都会使用一些Markdown转富文本的工具，比如markdown-nice，用的多了就会好奇是怎么实现的，于是就有了本篇文章。

markdown-nice是一个基于React构建的项目，先来看一下它的整体页面：

一个顶部工具栏，中间三个并列的区域，分别是编辑区域、预览区域、自定义主题区域，自定义主题区域默认是隐藏的。

大体上就是一个Markdown编辑器，增加了一些对各个平台的适配而已。

编辑器

编辑器使用的是CodeMirror，具体来说是一个二次封装的组件React-CodeMirror：

import CodeMirror from "@uiw/react-codemirror";

class App extends Component {
    render() {
        return (
        	<CodeMirror
                  value={this.props.content.content}
                  options={{
                    theme: "md-mirror",// 主题
                    keyMap: "sublime",// 快捷键
                    mode: "markdown",// 模式，也就是语言类型
                    lineWrapping: true,// 开启超长换行
                    lineNumbers: false,// 不显示行号
                    extraKeys: {// 配置快捷键
                      ...bindHotkeys(this.props.content, this.props.dialog),
                      Tab: betterTab,
                      RightClick: rightClick,
                    },
                  }}
                  onChange={this.handleThrottleChange}
                  onScroll={this.handleScroll}
                  onFocus={this.handleFocus}
                  onBlur={this.handleBlur}
                  onDrop={this.handleDrop}
                  onPaste={this.handlePaste}
                  ref={this.getInstance}
                />
        )
    }
}
复制代码

快捷键、命令

markdown-nice通过extraKeys选项设置一些快捷键，此外还在工具栏中增加了一些快捷按钮：

这些快捷键或者命令按钮操作文本内容的逻辑基本是一致的，先获取当前选区的内容：

const selected = editor.getSelection()
复制代码

然后进行加工修改：

`**${selected}**`
复制代码

最后替换选区的内容：

editor.replaceSelection(`**${selected}**`)
复制代码

此外也可以修改光标的位置来提升体验，比如加粗操作后光标位置会在文字后面，而不是*后面就是因为markdown-nice在替换完选区内容后还修改了光标的位置：

export const bold = (editor, selection) => {
  editor.replaceSelection(`**${selection}**`);
  const cursor = editor.getCursor();
  cursor.ch -= 2;// 光标位置向前两个字符
  editor.setCursor(cursor);
};
复制代码

表格

Markdown的表格语法手写起来是比较麻烦的，markdown-nice对于表格只提供了帮你插入表格语法符号的功能，你可以输入要插入的表格行列数：

确认以后会自动插入符号：

实现其实就是一个字符串的拼接逻辑：

const text = this.buildFormFormat(this.state.rowNum, this.state.columnNum);

buildFormFormat = (rowNum, columnNum) => {
    let formFormat = "";
    // 最少会创建三行
    for (let i = 0; i < 3; i++) {
        formFormat += this.buildRow(i, columnNum);
    }
    // 超过三行
    for (let i = 3; i <= rowNum; i++) {
        formFormat += this.buildRow(i, columnNum);
    }
    return formFormat;
};

buildRow = (rowNum, columnNum) => {
    let appendText = "|";
    // 第一行为表头和内容的分隔
    if (rowNum === 1) {
        appendText += " --- |";
        for (let i = 0; i < columnNum - 1; i++) {
            appendText += " --- |";
        }
    } else {
        appendText += "     |";
        for (let i = 0; i < columnNum - 1; i++) {
            appendText += "     |";
        }
    }
    return appendText + (/windows|win32/i.test(navigator.userAgent) ? "\r\n" : "\n");
};
复制代码

表格字符生成以后替换当前选区内容即可：

handleOk = () => {
    const {markdownEditor} = this.props.content;
    const cursor = markdownEditor.getCursor();

    const text = this.buildFormFormat(this.state.rowNum, this.state.columnNum);
    markdownEditor.replaceSelection(text);

    cursor.ch += 2;
    markdownEditor.setCursor(cursor);
    markdownEditor.focus();
};
复制代码

同样修改了光标位置并且让编辑器重新聚焦。