bm.md

多文件管理

bm.md 是一个专业的 Markdown 排版工具，专为内容创作者设计。本文档详细介绍所有功能特性。

[!NOTE] 复制到知乎、掘金功能还在开发中，敬请期待。

多文件管理

文件标签页

支持同时打开多个 Markdown 文件：

• 多标签切换 - 顶部标签栏显示所有打开的文件
• 双击重命名 - 双击标签可重命名文件
• 自动命名 - 根据文档首个 H1 标题自动命名
• IndexedDB 存储 - 文件内容持久化存储，刷新不丢失
• 新建文件 - 点击 + 按钮创建新文件
• 关闭文件 - 点击标签上的 ✕ 关闭文件

文件存储

• 文件元数据存储在 LocalStorage
• 文件内容存储在 IndexedDB
• 浏览器不支持时自动降级为内存存储

编辑器功能

Markdown 编辑器

基于 CodeMirror 6 构建的高性能编辑器：

• 语法高亮 - Markdown 语法实时着色
• 代码折叠 - 支持折叠代码块和长段落
• Ayu 主题 - 与整体 UI 风格统一的编辑器配色

文件导入

支持多种方式导入内容：

• 本地文件选择 - 支持 .md、.markdown 格式
• 拖拽导入 - 直接拖拽文件到编辑器区域
• 粘贴导入 - 支持粘贴 HTML 内容自动转换为 Markdown
• 快捷键 - Cmd/Ctrl + O 快速打开文件

Markdown 格式化

一键美化 Markdown 代码：

• 基于 markdownlint 规则自动修复
• 统一标题、列表、空行等格式
• 快捷键 Cmd/Ctrl + Shift + L

导出 Markdown

将编辑器内容保存为本地文件：

• 导出为 .md 文件
• 快捷键 Cmd/Ctrl + S

预览功能

实时预览

编辑即可见的预览体验：

• 增量更新 - 使用 morphdom 进行 DOM diff，仅更新变化部分
• 防抖渲染 - 100ms 防抖，避免频繁渲染
• 样式隔离 - iframe 沙箱隔离，预览样式不影响编辑器

视图切换

适配不同设备的预览宽度：

• 移动端视图 - 415px 宽度，iPhone 设备框展示
• 桌面端视图 - 768px 宽度，Safari 浏览器框展示
• 自动响应容器宽度变化

滚动同步

编辑器与预览区域双向滚动同步：

• 编辑器滚动时预览跟随
• 预览滚动时编辑器跟随
• 可通过设置开关此功能

主题系统

Markdown 排版样式

内置 13 种精心设计的排版风格：

代码高亮主题

支持 10 种代码块高亮主题（来自 highlight.js）：

浅色/深色模式

应用整体支持浅色和深色两种模式：

• 基于 next-themes 实现
• View Transition API 实现平滑切换动画

自定义 CSS

在主题样式基础上进行二次定制：

• 点击预览区工具栏的画笔图标打开配置
• CSS 选择器需约束在 #bm-md 下
• 自定义样式在主题样式之后应用，可覆盖默认样式
• 支持通过 API/MCP 传入 customCss 参数
• 配置自动保存到本地存储

示例：

/* 修改标题颜色 */
#bm-md h1 {
  color: #e74c3c;
}

/* 调整段落行高 */
#bm-md p {
  line-height: 1.8;
}

/* 自定义引用块样式 */
#bm-md blockquote {
  border-left-color: #9b59b6;
  background: #f8f4fc;
}

多平台导出

一键复制

针对不同平台优化的复制功能：

所有输出均使用 CSS 内联（通过 juice），可直接粘贴到富文本编辑器。

图片导出

将预览内容导出为图片：

• 使用 SnapDom 进行截图
• 输出 JPEG 格式

图片上传

临时图片存储

支持上传图片到临时存储：

• S3 兼容存储（可配置）
• 支持拖拽图片到编辑器
• 支持粘贴剪贴板图片
• 文件大小限制 5MB
• 支持常见图片格式

开发者集成

REST API

提供 4 个核心 API 端点：

完整 API 文档可访问 /docs 查看（Scalar UI）。

MCP 协议

支持 Model Context Protocol，可集成到 AI Agent：

• 提供 4 个工具：render、parse、extract、lint
• Streamable HTTP 传输
• 配置说明可访问 /docs/mcp 查看

PWA 支持

离线访问

应用支持 PWA（渐进式 Web 应用）：

• 离线可用 - 核心功能无需网络
• 可安装 - 支持添加到主屏幕
• 文件关联 - 支持在操作系统中直接用 bm.md 打开 .md 文件

快捷操作

命令面板

类似 Raycast/Spotlight 的全局命令面板：

• Cmd/Ctrl + K 打开
• 搜索所有可用命令
• 支持子菜单（主题选择等）

编辑器设置

可配置的编辑器行为：

Markdown 语法支持

基础语法

标题

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

文本格式

这是粗体文本，这是斜体文本，这是删除线文本，这是粗斜体文本。

列表

无序列表：

• 项目一
• 项目二

有序列表：

1. 第一项
2. 第二项

引用块

这是一段引用文字，可以用来强调重要内容或引用他人观点。

代码

行内代码：使用 const x = 1 定义常量。

代码块示例：

function greet(name) {
  console.info(`Hello,${name}!`)
}

greet('World')

链接与图片

这是一个普通链接，这是一个带标题的链接。

bm.md

GFM 扩展

表格

任务列表

自动链接

直接输入 URL 自动识别：https://bm.md

邮箱地址也支持：[email protected]

高级功能

脚注

Markdown1 是一种轻量级标记语言，由 John Gruber2 于 2004 年创建。

数学公式

支持 KaTeX 渲染。行内公式：E = mc^2，质能方程揭示了质量与能量的关系。

块级公式：

GitHub Alert

[!NOTE] 这是一条提示信息，用于补充说明。

[!TIP] 这是一条小技巧，帮助用户更好地使用功能。

[!IMPORTANT] 这是重要信息，请务必注意。

[!WARNING] 这是警告信息，操作前请三思。

[!CAUTION] 这是危险警告，可能导致数据丢失或不可逆操作。

1. Markdown 文件通常使用 .md 或 .markdown 扩展名。↩︎
2. John Gruber 是 Daring Fireball 博客的创始人。↩︎