版本: v1.0 更新日期: 2026-04-03 编辑器: Markdown编辑器
pnpm transform:csdn content/posts/your-article.md
复制内容: 点击”复制到剪贴板”按钮
上传图片: 根据📷 图片: xxx (请手动上传)提示上传本地图片
CSDN使用的是Markdown编辑器，具有以下特点：
基础语法
| 语法 | 示例 | 说明 |
|---|---|---|
| 标题 | # H1 ~ ###### H6 |
支持1-6级标题 |
| 粗体 | **粗体** |
双星号包围 |
| 斜体 | *斜体* |
单星号包围 |
| 粗斜体 | ***粗斜体*** |
三星号包围 |
| 删除线 | ~~删除线~~ |
双波浪线包围 |
| 行内代码 | `代码` |
反引号包围 |
| 代码块 | ```language |
三个反引号，可指定语言 |
| 分割线 | *** 或 --- |
三个或更多星号/短横线 |
列表
# 无序列表
- 项目1
- 项目2
- 嵌套项目
# 有序列表
1. 项目1
2. 项目2
# 任务列表
- [x] 已完成
- [ ] 未完成
引用
> 这是引用文本
> 可以有多行
链接和图片
# 链接
[CSDN](https://www.csdn.net)
[带标题](https://www.csdn.net "标题")
# 图片
表格（GFM）
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| A | B | C |
# 带对齐
| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| A | B | C |
数学公式（LaTeX）
CSDN支持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}CSDN支持多种编程语言的语法高亮，常见语言包括：
javascript / jstypescript / tspython / pyjavacpp / c++cgorustphprubyshell / bash / shcsshtml / xmljsonyaml / ymlsqlmarkdown / md| 语法 | 支持情况 | 说明 |
|---|---|---|
| 脚注 | ⚠️ 需确认 | 标准Markdown支持，但需测试CSDN是否支持 |
| 目录 | ❓ 未知 | 需测试 [TOC] 是否生效 |
| 定义列表 | ❌ 不支持 | 非标准语法 |
| 缩写 | ❌ 不支持 | 非标准语法 |
| 语法 | 说明 |
|---|---|
| 上标/下标（非公式） | 如 H~2~O 或 x^2^ |
| 高亮文本 | ==高亮== |
| Emoji短代码 | 如 :smile: （可直接输入Emoji字符） |
CSDN编辑器会过滤或转换部分HTML标签，以确保安全性。
基本支持（需测试确认）：
<div> - 块级容器<span> - 行内容器<p> - 段落<br> - 换行<a> - 链接<img> - 图片可能被过滤：
<script> - 脚本标签（安全原因）<iframe> - 内联框架（安全原因）<style> - 样式标签（可能被移除）on*事件属性的标签（安全原因）内联样式：
CSS类：
最佳实践：
✅ 完全支持外链图片
推荐做法：
支持的图片格式：
✅ 支持拖拽上传
操作方式：
图片大小限制：
基本语法：
尺寸控制：
对齐方式：
PostWaver的CSDN转换器位于 packages/transformer/src/to-csdn.ts，提供以下功能：
核心功能：
命令行使用：
# 转换单个文件
pnpm transform:csdn content/posts/your-article.md
# 转换并保存
pnpm transform:csdn content/posts/your-article.md > output/csdn-article.md
编程使用：
import { transformForCsdn } from '@content-hub/transformer'
const markdown = '# 标题\n\n这是内容'
const result = await transformForCsdn(markdown, {
removeLocalImages: true,
includeRelatedLinks: true,
postId: 'post-123',
relatedPosts: [...],
blogBaseUrl: 'https://your-blog.github.io/'
})
interface CsdnTransformOptions {
/** 文章ID */
postId?: string
/** 相关文章列表 */
relatedPosts?: IndexedPost[]
/** 博客基础URL */
blogBaseUrl?: string
/** 是否添加相关文章链接 */
includeRelatedLinks?: boolean
/** 是否移除本地图片（用于复制到外部平台） */
removeLocalImages?: boolean
}
当启用 removeLocalImages: true 时，转换器会：
assets/ 目录下的图片📷 图片: filename (请手动上传)示例：
# 输入
# 输出
📷 图片: screenshot.png (请手动上传)
┌─────────────────┐
│ 1. 写作Markdown │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 2. 转换为CSDN │ ← PostWaver
│ 格式 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 3. 复制到剪贴板 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 4. 粘贴到CSDN │ ← CSDN编辑器
│ 编辑器 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 5. 上传本地图片 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 6. 检查格式 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 7. 设置元数据 │
│ (标题/标签/分类)│
└────────┬────────┘
│
▼
┌─────────────────┐
│ 8. 发布文章 │
└─────────────────┘
pnpm dev
http://localhost:5173/publish 路由Web UI支持批量发布多篇文章到CSDN：
对于PostWaver项目，CSDN平台的转换策略：
// CSDN转换流程
1. 解析Markdown源文件
2. 验证语法兼容性（确保所有语法都被CSDN支持）
3. 处理特殊元素：
- 数学公式：保留LaTeX格式（CSDN支持）
- 代码块：确保语言标识正确
- 表格：确保使用GFM语法
4. 处理图片：
- 本地图片：转换为上传占位符
- 外链图片：直接保留
5. 输出：标准Markdown格式
数学公式
源格式：
$E = mc^2$
CSDN支持：✅ 完全支持，无需转换
任务列表
源格式：
- [x] 已完成
- [ ] 未完成
CSDN支持：✅ 完全支持（GFM语法）
// ❌ 不推荐
code here
// ✅ 推荐
```javascript
code here
```
|格式A: 推荐做法：
A: 检查：
A: 确保：
A: 检查：
$表示行内公式$$表示块级公式A:
A:
文章类型：
发布设置：
文章权限：
关键词设置：
文章描述：
在PostWaver项目中，发布到CSDN前应检查：
- [x]格式文档版本: v1.0 最后更新: 2026-04-03 维护者: PostWaver项目