CSDN

CSDN 是中国最大的 IT 技术社区，支持 Markdown 格式发布文章。

平台能力

资源策略

平台限制/注意事项

• Markdown 语法：支持标准 Markdown，包括 GFM 扩展
• 图片：支持外链图片，但建议使用 CSDN 图床以保证稳定性
• 代码块：支持语法高亮
• 数学公式：支持 LaTeX 语法（$...$ 和 $$...$$）
• 表格：支持 GFM 表格语法

发布流程

1. 预览内容

typub dev posts/my-post -p csdn

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

2. 复制内容

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

3. 打开编辑器

访问 CSDN Markdown 编辑器。

4. 粘贴内容

1. 在左侧编辑区域粘贴 Markdown 内容
2. 右侧会实时预览渲染效果

5. 处理图片

方式一：使用外链（推荐）

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

方式二：上传到 CSDN 图床

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

6. 发布

1. 点击 发布文章
2. 填写标题、摘要、标签
3. 选择文章类型和可见性
4. 点击 发布

配置选项

[platforms.csdn]
asset_strategy = "external"  # 默认值
output_dir = "output/csdn"   # 可选，自定义输出目录

Markdown 特性支持

常见问题

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

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

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

Q: 图片无法显示？

A: 检查图片 URL 是否可访问。建议：

1. 使用 asset_strategy = "external" 并配置可靠的 CDN
2. 或者手动上传到 CSDN 图床

Q: 数学公式渲染异常？

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

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