# MetonaEditor > 轻量、零依赖、精致美观的 Markdown Editor 库。单文件，开箱即用，中文优先。 [![npm version](https://img.shields.io/badge/version-0.1.3-blue.svg)](https://www.npmjs.com/package/@metona-team/metona-editor) [![license](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE) [![tests](https://img.shields.io/badge/tests-425%20passed-brightgreen.svg)](./tests) [![coverage](https://img.shields.io/badge/coverage-97%25-brightgreen.svg)](./tests) --- ## 特性 - **零依赖** — 单文件打包，无任何运行时依赖，UMD/ESM/CJS 三种格式 - **现代化** — 原生 ES2020+ 实现，CSS 变量主题系统，响应式布局，无障碍支持 - **易扩展** — 完整插件系统（install/destroy 生命周期），自定义工具栏按钮，预设插件开箱即用 - **易维护** — 模块化源码，JSDoc 注释完整，TypeScript 类型声明，425 个单元测试覆盖 - **易使用** — 工厂函数 `create()` 一行接入，链式 API，中文优先文档与翻译 - **安全** — 内置 XSS 防护（`javascript:`/`vbscript:`/`file:` 协议过滤），HTML 转义，`safeUrl` 净化 - **内置解析器** — 自研 CommonMark 子集 + GFM 扩展（表格含列对齐、任务列表、emoji 短码、上下标），可整体替换 - **三模式视图** — edit / split / preview 自由切换，分屏拖拽调整比例，滚动同步，模式切换保持滚动位置 - **主题系统** — light / dark / auto / warm 四套预设，CSS 变量定制，跟随系统主题，@media print 打印样式 - **国际化** — zh-CN / en-US 完整翻译，RTL 支持，`Intl` 数字/货币/日期格式化 - **历史栈** — 撤销/重做，防抖合并（可配置延迟），可配置上限 - **只读模式** — `readOnly` 配置 / `setReadOnly()` API，适用于预览/展示场景 - **预设插件** — autoSave（草稿）、exportTool（导出 .md/.html）、searchReplace（Ctrl+F 查找替换）、imagePaste（粘贴图片转 base64） - **性能优化** — 渲染缓存跳过重复解析，`refresh()` 强制刷新，模式切换无冗余渲染 --- ## 目录 - [快速开始](#快速开始) - [配置项](#配置项) - [API 参考](#api-参考) - [事件系统](#事件系统) - [插件系统](#插件系统) - [主题系统](#主题系统) - [国际化](#国际化) - [Markdown 解析器](#markdown-解析器) - [TypeScript 支持](#typescript-支持) - [测试](#测试) - [构建](#构建) - [浏览器兼容性](#浏览器兼容性) - [License](#license) --- ## 快速开始 ### 安装 ```bash npm install @metona-team/metona-editor ``` ### 浏览器直接引入（UMD） > 样式由 JS 自动注入（`styles.js` 运行时动态创建 `