博客园 (CNBlogs)

博客园是中国知名的技术博客平台，支持 Markdown 格式发布文章。

平台能力

资源策略

平台限制/注意事项

• Markdown 语法：支持标准 Markdown，包括 GFM 扩展
• 编辑器选择：推荐使用 Markdown 或 Editor.md 编辑器
• 图片：支持 Base64 内嵌和外链图片
• 代码块：支持语法高亮
• 数学公式：支持 LaTeX 语法，但需要手动开启
• 表格：支持 GFM 表格语法

发布流程

1. 预览内容

typub dev posts/my-post -p cnblogs

浏览器会打开预览页面，显示生成的 Markdown 内容。

2. 复制内容

点击预览页面的 复制内容 按钮，将 Markdown 文本复制到剪贴板。

3. 打开编辑器

访问 博客园写文章。

4. 选择编辑器

点击右上角的 编辑器 下拉菜单，选择 Markdown 或 Editor.md。

提示：Markdown 和 Editor.md 都能支持我们需要的功能。Editor.md 提供实时预览。

5. 粘贴内容

在 Markdown 编辑区域粘贴内容。

6. 开启数学公式支持

博客园默认不开启数学公式渲染，需要手动开启：

1. 点击编辑器右侧的 数学公式 按钮
2. 勾选 启用数学公式支持
3. 选择渲染引擎（推荐 MathJax3）
4. 点击 确定

7. 处理图片

方式一：使用 Base64 内嵌（推荐）

博客园 Markdown 编辑器支持 Base64 内嵌图片，使用默认的 asset_strategy = "embed" 即可，无需额外处理。

方式二：使用外链

如果使用 asset_strategy = "external"，图片 URL 会直接嵌入 Markdown 中，无需额外处理。

方式三：上传到博客园

1. 点击编辑器工具栏的 图片 按钮
2. 选择本地上传
3. 替换 Markdown 中的图片链接

8. 发布

1. 填写标题
2. 选择文章分类和标签
3. 点击 发布

配置选项

[platforms.cnblogs]
# asset_strategy = "embed"  # 默认，使用 Base64 内嵌图片

Markdown 特性支持

常见问题

Q: 数学公式不渲染？

A: 博客园默认不开启数学公式支持。请按照上述步骤手动开启：

1. 点击 数学公式 按钮
2. 勾选 启用数学公式支持
3. 选择 MathJax3 引擎

Q: 代码块没有语法高亮？

A: 确保代码块指定了语言标识：

```python
print("hello")
```

Q: 图片无法显示？

A: 博客园支持 Base64 内嵌图片，默认配置即可正常显示。如果使用外链图片，检查 URL 是否可访问。

Q: 应该选择哪个编辑器？

A: 推荐使用 Markdown 或 Editor.md：

• Markdown：默认 Markdown 编辑器，简洁
• Editor.md：提供实时预览功能

TinyMCE 和 TinyMCE5 是 HTML 富文本编辑器，不适合直接粘贴 Markdown。