版本: v1.0 更新日期: 2026-04-01 编辑器: ByteMD (字节跳动开源)
掘金使用的是ByteMD编辑器，这是字节跳动开源的Markdown编辑器，具有以下特点：
| 语法 | 示例 | 说明 |
|---|---|---|
| 标题 | # H1 ~ ###### H6 |
支持1-6级标题 |
| 粗体 | **粗体** |
双星号包围 |
| 斜体 | *斜体* |
单星号包围 |
| 粗斜体 | ***粗斜体*** |
三星号包围 |
| 删除线 | ~~删除线~~ |
双波浪线包围 |
| 行内代码 | `代码` |
反引号包围 |
| 代码块 | ```language |
三个反引号，可指定语言 |
| 分割线 | *** 或 --- |
三个或更多星号/短横线 |
# 无序列表
- 项目1
- 项目2
- 嵌套项目
# 有序列表
1. 项目1
2. 项目2
# 任务列表
- [x] 已完成
- [ ] 未完成
> 这是引用文本
> 可以有多行
# 链接
[掘金](https://juejin.cn)
[带标题](https://juejin.cn "标题")
# 图片
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| A | B | C |
# 带对齐
| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| A | B | C |
掘金通过ByteMD插件支持LaTeX数学公式：
行内公式：
$E = mc^2$
块级公式：
$$
\frac{n!}{k!(n-k)!} = \binom{n}{k}
$$
常用符号：
x^2H_2O\frac{a}{b}\sqrt{x}\sum_{i=1}^{n}\int_{a}^{b}\```mermaid
graph TD
A[开始] --> B{判断}
B -->|是| C[操作1]
B -->|否| D[操作2]
C --> E[结束]
D --> E
\```
掘金支持多种编程语言的语法高亮，常见语言包括：
javascript / jstypescript / tspython / pyjavacpp / c++cgorustphprubyshell / bash / shcsshtml / xmljsonyaml / ymlsqlmarkdown / md| 语法 | 支持情况 | 说明 |
|---|---|---|
| 脚注 | ⚠️ 需确认 | 标准Markdown支持，但需测试掘金是否支持 |
| 目录 | ❓ 未知 | 需测试 [TOC] 是否生效 |
| 定义列表 | ❌ 不支持 | 非标准语法 |
| 缩写 | ❌ 不支持 | 非标准语法 |
| 语法 | 说明 |
|---|---|
| 上标/下标（非公式） | 如 H~2~O 或 x^2^ |
| 高亮文本 | ==高亮== |
| - Emoji短代码 | 如 :smile: （可直接输入Emoji字符） |
掘金的ByteMD编辑器会过滤或转换部分HTML标签，以确保安全性。
基本支持（需测试确认）：
<div> - 块级容器<span> - 行内容器<p> - 段落<br> - 换行<a> - 链接<img> - 图片可能被过滤：
<script> - 脚本标签（安全原因）<iframe> - 内联框架（安全原因）<style> - 样式标签（可能被移除）on*事件属性的标签（安全原因）内联样式：
CSS类：
最佳实践：
✅ 完全支持外链图片
推荐做法：
支持的图片格式：
✅ 支持拖拽上传
操作方式：
图片大小限制：
基本语法：
尺寸控制：
对齐方式：
✅ 支持良好
推荐编辑器：
行为：
⚠️ 可能丢失格式
来源：
建议：
⚠️ 需要清理格式
行为：
建议工具：
掘金编辑器支持的快捷键：
| 操作 | Windows/Linux | macOS |
|---|---|---|
| 粗体 | Ctrl + B |
Cmd + B |
| 斜体 | Ctrl + I |
Cmd + I |
| 插入链接 | Ctrl + K |
Cmd + K |
| 插入代码 | Ctrl + Shift + C |
Cmd + Shift + C |
| 行内代码 | Ctrl + Shift + K |
Cmd + Shift + K |
| 插入图片 | Ctrl + Shift + I |
Cmd + Shift + I |
| 无序列表 | Ctrl + Shift + L |
Cmd + Shift + L |
| 撤销 | Ctrl + Z |
Cmd + Z |
| 重做 | Ctrl + Shift + Z |
Cmd + Shift + Z |
对于Content Hub项目，掘金平台的转换策略：
// JuejinConverter 转换流程
1. 解析Markdown源文件
2. 验证语法兼容性（确保所有语法都被掘金支持）
3. 处理特殊元素：
- 数学公式：保留LaTeX格式（掘金支持）
- Mermaid图表：保留语法（掘金支持）
- 代码块：确保语言标识正确
4. 处理图片：
- 本地图片：提示用户手动上传
- 外链图片：直接保留
5. 输出：标准Markdown格式
源格式：
$E = mc^2$
掘金支持：✅ 完全支持，无需转换
源格式：
这是脚注[^1]
[^1]: 脚注内容
掘金支持：⚠️ 需测试
源格式：
- [x] 已完成
- [ ] 未完成
掘金支持：✅ 完全支持（GFM语法）
// ❌ 不推荐
code here
// ✅ 推荐
```javascript
code here
```
|格式A: 推荐做法：
A: 检查：
A: 确保：
A: 检查：
$表示行内公式$$表示块级公式A:
在Content Hub项目中，发布到掘金前应检查：
- [x]格式文档版本: v1.0 最后更新: 2026-04-01 维护者: Content Hub项目