Files
XCDesktop/command/Markdown整理要求.md
2026-03-08 01:34:54 +08:00

142 lines
7.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Markdown文本全维度修复+标准化整理+视觉化美化要求
注意一定要按照章节来制定计划!!!!!!!!!!!!!!!
没让你翻译就别乱翻译,一定要保证原文内容不变!!!!!!!!!!
一定注意主章节要跟标题一样用一级#
>引用块里面的结构也需要注意,现在引用块里面的层级都被打乱了,需要你重新整理。
## 一、任务拆分
### 1.1 章节划分
严格根据文档原有章节划分处理单元,按章节依次推进修复、整理、美化工作,不一次性对全文档操作,单章节处理完成后再进行下一章节,跨章节格式保持完全统一。
### 1.2 操作原则
直接在原文档中改,不要新建修改版。
乱码需要清理干净,如:
---
## 二、核心格式修复(重点解决高频错误)
### 2.1 列表格式修复
- **修正列表层级错位**:核心解决主项与子项无缩进的问题(如主项* 标题,其子项需空两格后加*,而非与主项平齐),确保父子列表层级语法、视觉均清晰,比如「多人地图 / 单人战役」这类主项的子说明,必须作为子项缩进展示,杜绝所有子项与主项同级的错误;
- **修正无序列表基础错误**:规范无序列表的使用逻辑,保留原文列表意图,杜绝*被错误删除、替换、乱序的情况;
- **修正有序列表错误**:确保有序列表使用数字+点的格式如1. 内容),避免使用错误的标记。
### 2.2 文本格式修复
- **修正加粗符号错误**:确保加粗内容为**内容**正确渲染格式,杜绝**内容**转义符未生效的错误,无加粗符号缺失、多余情况;
- **修正斜体标记错误**:确保斜体内容为*内容*正确渲染格式,无斜体符号缺失、多余情况;
- **修正删除线格式**:确保删除线内容为~~内容~~正确渲染格式。
### 2.3 表格格式修复
- 修正表格格式错误:完整保留表格原有结构,杜绝表格被分散展开、行列错乱、分隔符缺失的问题,确保表格语法完整、渲染正常;
- 调整表格列宽与对齐方式,确保表格美观易读。
### 2.4 代码块格式修复
- 确保代码块使用```语言```和```的格式,正确标注代码语言;
- 修正未闭合的代码块,确保代码块独立成段。
### 2.5 链接格式修复
- 确保链接使用[锚文本](URL)的格式,无未闭合的链接;
- 长链接做合理处理,避免影响文档排版。
### 2.6 数学公式格式修复
- 确保行内公式使用$公式$的格式;
- 有些公式是块级公式却误用了行内公式格式,需修正为$$公式$$的格式,且$$符号需要单独占一行;
- 修正公式中的转义符错误,确保公式正确渲染。
### 2.7 基础语法兜底
- 同步修正错位的标题层级、未闭合的链接/代码块、乱码的特殊符号、错误的斜体标记确保所有Markdown语法准确生效无失效或错误格式。
---
## 三、结构整理
### 3.1 段落划分
- 梳理各章节内文本逻辑脉络,按内容模块划分段落(段落间空一行);
- 确保每个段落中心思想明确,内容连贯。
### 3.2 列表规范
- 统一有序/无序列表的缩进规范,确保列表层级清晰;
- 列表项内容过长时,确保换行后缩进对齐。
### 3.3 标题层级
- 统一标题层级:一级# 文档标题和主章节、二级 ## 大模块/子章节、三级 ### 子分类,不越级使用;
- 标题与正文间保留合理间距,章节标题样式统一。
---
## 四、视觉美化
### 4.1 标题美化
- 标题:按「一级# 文档标题和主章节、二级 ## 大模块/子章节、三级 ### 子分类」分层,不越级使用,标题与正文间保留合理间距,章节标题样式统一;
- 标题前后添加适当的空行,增强视觉层次感。
### 4.2 文本美化
- 重点:关键信息用粗体标注(避免大面积粗体),辅助说明用斜体,禁用过多花哨格式;
- 避免一行文本过长,适当控制行宽,提高可读性。
### 4.3 分隔美化
- 不同章节间、章节内不同模块间用---分隔线清晰区隔,避免内容堆砌;
- 分隔线前后添加适当的空行,增强视觉效果。
### 4.4 图片美化
- 图片格式不要在方括号中加任何东西,直接![]即可;
- 图片添加简洁说明且居中(若支持),图片前后添加适当的空行。
### 4.5 代码块美化
- 代码块独立成段并标注对应语言,代码块前后添加适当的空行;
- 确保代码块格式正确,缩进统一。
---
## 五、细节优化
### 5.1 空格规范
- 统一中英文/数字与标点间的空格,确保格式一致;
- 避免多余的空格和制表符。
### 5.2 文本优化
- 修正各章节内错别字与不通顺语句,确保文本流畅;
- 删除冗余空行、重复内容和无意义符号,文本整洁紧凑。
### 5.3 特殊符号处理
- 修正乱码的特殊符号,确保特殊符号正确显示;
- 避免使用过多的特殊符号,影响文档可读性。
---
## 六、核心原则
### 6.1 保留原义
- 所有修改均基于原文核心内容,不增删、不篡改各章节原文,仅优化格式与排版!!!这个是最重要的
### 6.2 一致性原则
- 跨章节格式保持完全统一,确保文档整体风格一致;
- 相同类型的内容使用相同的格式处理。
### 6.3 可读性优先
- 所有修改以提高文档可读性为首要目标;
- 避免过度格式化,确保文档简洁明了。
---
## 七、输出要求
### 7.1 输出格式
- 请按章节输出处理后的Markdown文本每章节处理完成后标注该章节主要修改点确保修复后的文本在任意Markdown编辑器中正常渲染阅读体验更佳。
### 7.2 图片格式
- 图片格式不要在方括号中加任何东西,直接![]即可。整理格式,直接给我。
### 7.3 检查清单
- 整体划分清晰章节使用一级、二级、三级标题分层不越级符合Markdown标题规范
- 任务拆分章节:拆分独立段落,修正段落间距,使核心要求(按章节处理、不新建版本)清晰突出;
- 核心格式修复章节:将原有零散要求整理为无序列表,规范列表缩进(无层级错位),修正语句间距,确保每类错误修复要求独立明确;
- 结构整理/细节优化/核心原则/输出要求章节:拆分独立段落,删除冗余空格,统一段落间距,关键提示(保留原义)突出;
- 视觉美化章节:将原有零散美化要求整理为无序列表,规范缩进,明确每类美化标准;
- 全局:添加合理分隔线(章节间),统一段落间距,修正语句排版,确保无加粗错误、无格式错乱,保留原文所有核心要求,未增删任何内容。
---
## 十、总结
Markdown文档的整理和美化是一个需要细心和耐心的工作遵循以上规范和建议可以确保文档格式正确、结构清晰、视觉美观提高文档的可读性和专业度。在处理过程中始终牢记核心原则保留原义仅优化格式与排版。