Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

51CTO 博客

51CTO 博客是中国知名的 IT 技术博客平台,支持 Markdown 格式发布文章。

平台能力

特性支持情况
输出格式Markdown
默认主题无(纯 Markdown)
特殊转换

资源策略

策略支持默认
embed(Base64 内嵌)*
external(外部存储)

平台限制/注意事项

  • Markdown 语法:支持标准 Markdown,包括 GFM 扩展
  • 图片:支持 Base64 内嵌和外链图片
  • 代码块:支持语法高亮
  • 数学公式:支持 LaTeX 语法($...$$$...$$
  • 表格:支持 GFM 表格语法

发布流程

1. 预览内容

typub dev posts/my-post -p 51cto

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

2. 复制内容

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

3. 打开编辑器

访问 51CTO 博客发布页面

4. 粘贴内容

在 Markdown 编辑区域粘贴内容,右侧会实时预览渲染效果。

粘贴内容

5. 处理图片

方式一:使用 Base64 内嵌(推荐)

51CTO 编辑器支持 Base64 内嵌图片,使用默认的 asset_strategy = "embed" 即可,无需额外处理。

方式二:使用外链

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

方式三:上传到 51CTO

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

6. 发布

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

配置选项

[platforms.51cto]
# asset_strategy = "embed"  # 默认,使用 Base64 内嵌图片

Markdown 特性支持

特性支持说明
标题# ~ ######
列表有序、无序、嵌套
代码块支持语法高亮
表格GFM 格式
引用> 语法
链接外链、内部链接
图片Base64、外链或上传
数学公式LaTeX 语法
任务列表- [ ] / - [x]
脚注不支持

常见问题

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

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

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

Q: 图片无法显示?

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

Q: 数学公式渲染异常?

A: 51CTO 使用 KaTeX 渲染公式。某些 LaTeX 命令可能不支持。常见问题:

  • 避免使用 \begin{align} 等复杂环境
  • 使用 \displaystyle 替代 \dfrac