README-CN.md

🎄 md-editor-rt

English | 中文

react版本的 Markdown 编辑器，使用jsx和typescript开发。

• 文档与在线预览：传送门

• md-editor-v3同系列项目。

⭐️ 功能一览

• 快捷插入内容工具栏、编辑器浏览器全屏、页面内全屏等。
• 内置的白色主题和暗黑主题，支持绑定切换。
• 支持快捷键插入内容； 支持使用 prettier 格式化内容（使用 CDN 方式引入，只支持格式化 md 内容，可在代码内设置关闭）。
• 多语言，支持自行扩展语言。
• 粘贴上传图片，图片裁剪上传。
• 仅预览模式（不显示编辑器，只显示 md 预览内容，无额外监听）。
• 预览主题，内置default、vuepress、github 、cyanosis、mk-cute、smart-blue 6 种预览主题（不完全相同），支持自定义主题（参考文档 demo 页示例）。
• mermaid绘图（>=1.3.0），katex数学公式（>=1.4.0）。
• 自定义工具栏顺序或显示，自定义扩展工具栏（支持点击类型、下拉菜单类型及弹窗类型）等。
• 按需引用(>=4.0.0)。

🗺 预览图

默认模式	暗黑模式	仅预览

输入提示和自定义简单的标记、表情扩展预览

📦 安装

yarn add md-editor-rt

使用已存在的语言、主题扩展，例如：日语

yarn add @vavt/cm-extension

使用更多的扩展工具栏组件，例如：导出内容为 PDF

yarn add @vavt/rt-extension

更多使用及贡献方式参考：md-editor-extension

💡 用法

从v4.0.0开始，内部组件支持按需引用。

✍🏻 编辑器模式

import React, { useState } from 'react';
import { MdEditor } from 'md-editor-rt';
import 'md-editor-rt/lib/style.css';

export default () => {
  const [text, setText] = useState('# Hello Editor');
  return <MdEditor modelValue={text} onChange={setText} />;
};

📖 仅预览模式

import React, { useState } from 'react';
import { MdEditor, MdCatalog } from 'md-editor-rt';
import 'md-editor-rt/lib/preview.css';

const scrollElement = document.documentElement;

export default () => {
  const [text] = useState('# Hello Editor');
  const [id] = useState('preview-only');

  return (
    <>
      <MdEditor id={id} modelValue={text} />
      <MdCatalog editorId={id} scrollElement={scrollElement} />
    </>
  );
};

当使用服务端渲染时，scrollElement应该是字符类型，例：html、body、#id、.class。

---

更多用法请前往 文档。