# Cn Markdown Typeset
> 中文 Markdown 排版引擎 Skill
- Skill: `winkooui/cn-markdown-typeset` (Agent Skill)
- Install (CLI): `npx skillmds@latest add winkooui/cn-markdown-typeset`
- Raw SKILL.md: https://api.skillmd.com/api/skills/winkooui/cn-markdown-typeset/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: winkooui (https://skillmd.com/u/winkooui)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/winkooui/cn-markdown-typeset
---
# 中文 Markdown 排版引擎 Skill
将 Markdown 文本转换为排版精美的中文文档（HTML/PDF），解决中文排版中字体、间距、标点、分行的常见痛点。
---
## 元信息
- **名称**: cn-markdown-typeset
- **触发词**: "排版"、"美化"、"中文排版"、"生成文档"、"Markdown 转"、"PDF"
- **适用场景**: 技术博客、知识沉淀、报告输出、简历排版、文档导出
- **输出格式**: HTML（默认）→ 可通过浏览器打印为 PDF
## 中文排版规范
### 字体栈
```css
/* 正文 */
font-family: "LXGW WenKai", "Noto Serif CJK SC", "Source Han Serif SC",
"PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
/* 标题 */
font-family: "Noto Sans CJK SC", "Source Han Sans SC",
"PingFang SC", "Hiragino Sans GB", sans-serif;
/* 代码 */
font-family: "JetBrains Mono", "Fira Code", "Source Code Pro",
"SF Mono", "Consolas", monospace;
```
### 字号层级
| 层级 | 字号 | 字重 | 行距 |
|------|------|------|------|
| H1 | 28px | 700 | 1.4 |
| H2 | 22px | 600 | 1.4 |
| H3 | 18px | 600 | 1.5 |
| 正文 | 15px | 400 | 1.8 |
| 引用 | 14px | 400 | 1.7 |
| 代码 | 13px | 400 | 1.6 |
| 注释 | 12px | 400 | 1.5 |
### 中文排版规则
#### 1. 标点挤压（Punctuation Kerning）
中文标点与西文/数字之间自动添加 1/4 em 空格：
```css
/* 自动处理中英文间距 */
p, li, span {
text-autospace: ideograph-alpha ideograph-numeric;
}
```
#### 2. 首行缩进
正文段落首行缩进 2 em：
```css
p {
text-indent: 2em;
margin-bottom: 1em;
}
```
#### 3. 中西文混排
- 中英文之间自动加空格（`text-autospace` 或正则处理）
- 引号使用中文弯引号："「」" 或 """"
- 破折号使用 ——（两个 em dash）
#### 4. 行首行尾禁则
- 行首不出现句号、逗号、感叹号、问号、右引号、右括号
- 行尾不出现左引号、左括号
- 使用 `word-break: break-all` 和 CSS `overflow-wrap` 处理
### 页面布局
```css
/* A4 纸张 */
@page {
size: A4;
margin: 2.5cm 2cm;
}
/* 阅读宽度限制 */
.container {
max-width: 720px;
margin: 0 auto;
padding: 3rem 0;
}
/* 页面边距 */
@media print {
body { margin: 0; }
.container { padding: 0; }
}
```
## HTML 模板结构
```html
{{document_title}}
{{content}}
```
## 执行流程
```
用户输入 Markdown 内容
│
▼
① 内容解析
├─ 识别标题层级
├─ 提取列表、表格、代码块
└─ 标记需要特殊处理的元素
│
▼
② 中文排版处理
├─ 中英文间自动加空格
├─ 标点挤压优化
├─ 首行缩进设置
└─ 引号/破折号规范化
│
▼
③ 渲染 HTML
├─ 应用模板 CSS
├─ 嵌入内容
└─ 生成为单文件 HTML
│
▼
④ 输出
├─ 默认输出 HTML 文件
└─ 用户要求 PDF 时，Chrome headless 打印
```
## 质量检查清单
- [ ] 中英文之间是否有适当间距
- [ ] 标题层级是否正确（H1 → H2 → H3，无跳跃）
- [ ] 段落首行是否缩进 2em
- [ ] 表格对齐是否整齐
- [ ] 代码块是否语法高亮
- [ ] 引用块是否有左侧竖线
- [ ] 打印模式下分页是否合理
- [ ] 字体是否正确加载
## 注意事项
- 纯英文内容不应用首行缩进
- 代码块中不处理中文排版规则
- 表格内容超出宽度时允许横向滚动
- PDF 输出时确保字体已嵌入