如何快速上手 EasyMDE：零代码打造专业 Markdown 编辑体验 ✨

EasyMDE 是一款简单美观、可嵌入式的 JavaScript Markdown 编辑器，专为新手和专业用户设计，提供愉悦的编辑体验。它支持实时预览、自动保存和拼写检查，让 Markdown 写作变得轻松高效。无论是博客创作、文档编辑还是内容管理系统，EasyMDE 都能满足你的需求。

🚀 为什么选择 EasyMDE？三大核心优势

1. 零基础友好，上手即会

无需记忆复杂语法！通过直观的工具栏按钮（如粗体、列表、链接）和快捷键，即使是 Markdown 新手也能快速创建格式化文本。编辑器底部的状态栏还会实时显示字数统计和编辑状态，让你对内容了如指掌。

2. 实时预览，所见即所得

告别“编辑-预览”反复切换的麻烦！EasyMDE 提供分屏实时预览功能，左侧输入 Markdown 语法，右侧立即显示渲染效果，让排版调整更直观、更高效。

3. 高度可定制，适配多样场景

无论是个人博客还是企业系统，EasyMDE 都能灵活适配：

• 主题定制：支持自定义 CSS 样式，匹配你的网站风格
• 功能开关：可按需启用/禁用自动保存、拼写检查等功能
• 尺寸调整：支持全屏编辑和分屏比例调整，适应不同屏幕大小

💻 三步快速集成：从下载到使用

1. 获取源码，两种方式任选

方式一：直接下载源码包

访问项目仓库下载最新版本：https://gitcode.com/gh_mirrors/ea/easy-markdown-editor，解压后即可获取完整源码。

方式二：通过 Git 克隆

打开终端，执行以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/ea/easy-markdown-editor

2. 引入核心文件，一行代码搞定

在你的 HTML 页面中引入编译后的 CSS 和 JS 文件（位于 dist/ 目录）：

<link rel="stylesheet" href="dist/easymde.min.css">
<script src="dist/easymde.min.js"></script>

3. 初始化编辑器，立即使用

在页面中添加一个 <textarea> 标签，并通过 JavaScript 初始化 EasyMDE：

<textarea></textarea>
<script>
  const easyMDE = new EasyMDE(); // 默认配置
</script>

如需自定义配置（如禁用工具栏按钮、修改预览模式），可参考 src/js/easymde.js 中的参数说明。

🎨 实用功能示例：让编辑更高效

自动保存，再也不怕丢内容 ⚠️

编辑器会自动保存你的输入内容（默认每 10 秒一次），即使意外关闭页面，重新打开后也能恢复之前的编辑状态。这一功能由 src/js/easymde.js 中的 autosave 模块实现，无需额外配置即可使用。

图片上传，轻松插入本地图片 🖼️

点击工具栏的图片按钮，即可通过弹窗选择本地图片并插入。编辑器会自动生成 Markdown 图片语法，支持拖拽上传和尺寸调整，让图文排版更简单。

拼写检查，避免低级错误 ✅

内置拼写检查功能（需浏览器支持），实时标记拼写错误的单词，点击即可查看纠正建议，让你的文档更专业、更准确。

📚 更多资源：从示例到定制

查看官方示例，快速参考

项目的 example/ 目录提供了多个使用案例，如：

• index.html：默认配置示例，展示基础功能
• index_sideBySideFullscreenFalse.html：分屏预览且禁用全屏模式的配置

自定义配置，打造专属编辑器

如需深度定制，可修改配置参数。例如，禁用自动保存并调整工具栏按钮：

const easyMDE = new EasyMDE({
  autosave: { enabled: false },
  toolbar: ["bold", "italic", "|", "link", "image", "|", "preview"]
});

更多配置选项可参考 types/easymde.d.ts 中的类型定义。

🤔 常见问题：新手必看

Q：如何修改编辑器的默认主题？

A：可以通过自定义 CSS 覆盖 src/css/easymde.css 中的样式，或在初始化时指定 previewClass 参数添加自定义类名。

Q：支持移动端编辑吗？

A：是的！EasyMDE 采用响应式设计，在手机、平板等移动设备上也能正常使用，工具栏会自动适配屏幕尺寸。

Q：能否集成到 React/Vue 项目中？

A：可以！虽然官方未提供框架专用组件，但可通过原生 JavaScript 初始化方式在任何前端框架中使用。

✨ 写在最后：让 Markdown 编辑更愉悦

无论是日常写作、技术文档还是内容管理，EasyMDE 都能帮你告别繁琐，专注于内容本身。它的开源特性意味着你可以自由修改源码（核心逻辑位于 src/js/easymde.js），甚至贡献代码参与项目改进。

如果你正在寻找一款简单、强大且免费的 Markdown 编辑器，不妨试试 EasyMDE——让编辑成为一种享受！🎉