1. 从一份试题源码说起为什么我要把CSP-J初赛题做成Markdown每年CSP-J/S初赛结束后的那几天信息学竞赛圈子里最热闹的事情之一就是各路选手、教练、家长到处找真题和答案。我带了几年竞赛班每年这个时候都会被问同样的问题“有没有今年的题”“答案对不对”“能不能发我一份方便打印的”说实话早些年大家都是拿PDF或者图片在群里传来传去清晰度参差不齐答案还经常有争议最要命的是想自己整理一份错题本得对着图片一个字一个字敲效率低到让人抓狂。所以从几年前开始我养成了一个习惯每届CSP-J第一轮结束后我会把试题和解析整理成Markdown源码用纯文本的方式保存下来。这样做的好处非常直接——Markdown是纯文本任何编辑器都能打开体积小、易传播用Markdown表格整理选择题选项和答案一目了然配合数学公式语法还能把阅读程序、完善程序里的表达式写清楚最关键的是源码可以随时转成PDF、Word、HTML想打印就打印想导入笔记软件就导入完全不受平台限制。这篇博文就是围绕“CSP-J2026第一轮试题附答案解析、Markdown源码”这个主题把我整理这套资料的完整思路、技术细节、踩过的坑以及一份可直接复用的Markdown模板结构全部摊开来讲。不管你是第一次接触CSP-J的选手还是想自己动手整理真题的教练或者只是好奇“一份竞赛试题的Markdown源码到底长什么样”都能从这里找到能直接抄作业的东西。我会重点讲清楚三件事为什么用Markdown而不是Word/PDF、一份高质量的试题Markdown该怎么组织结构、整理过程中那些只有亲手做过才知道的细节和坑。2. 为什么是Markdown试题整理场景下的格式选型逻辑2.1 试题资料的三大核心诉求可读、可改、可转整理任何一份竞赛试题本质上要同时满足三个诉求。第一是可读性选手拿到手要能快速看清题干、选项、代码第二是可修改性答案有争议、题干有笔误、解析要补充这些都得能随时改第三是可转换性同一份内容要能变成打印版、网页版、笔记版。Word和PDF在这三点上各有短板。PDF可读性最好但几乎不可改想修正一个错别字都得重新排版Word可改但格式容易乱尤其是代码块和数学公式换个电脑打开字体就飞了而且.doc/.docx是二进制格式用Git做版本管理基本没戏。Markdown恰好卡在中间纯文本保证可改可版本管理语法简洁保证可读配合Pandoc之类的工具又能转成几乎任何格式。我实测下来一份完整的CSP-J初赛试题Markdown源码体积通常在30KB到80KB之间微信直接发文件、邮件附件、粘贴到在线编辑器全都毫无压力。而同样内容的PDF往往要1MB以上图片版更是动辄好几MB。2.2 Markdown处理试题的独特优势表格、代码块与公式CSP-J第一轮试题的结构其实很固定单项选择题15题左右、阅读程序题3大题每大题含判断题和选择题、完善程序题2大题。这个结构里有两类内容对格式要求特别高。第一类是选择题的选项。15道单选每题4个选项如果用普通段落写读者眼睛会花。Markdown表格在这里简直是量身定做| 题号 | 题目 | A | B | C | D | 答案 | |------|------|---|---|---|---|------| | 1 | 在C中下列哪个是合法的标识符 | 2var | _var | var-1 | int | B |第二类是程序代码。阅读程序和完善程序题里全是C代码Markdown的围栏代码块cpp能保证代码等宽显示、语法高亮、缩进不丢失。这一点Word经常做不好复制粘贴过去缩进就乱了。第三类是数学表达式。初赛里涉及进制转换、复杂度计算、排列组合用LaTeX语法写在Markdown里配合支持数学公式的阅读器比如Typora、VS Code加插件、Obsidian就能渲染成漂亮的公式。比如时间复杂度写成 $O(n \log n)$比手打“O(n log n)”规范得多。2.3 一个容易被忽略的点Markdown让协作和纠错变得简单竞赛试题的答案和解析从来不是一个人说了算的。我整理的时候通常会拉上两三个教练一起核对这时候Markdown的纯文本特性就体现出价值了。每个人改完直接对比差异谁改了哪道题的解析一目了然。如果用Word两个人同时改一份文件合并的时候能让人崩溃。另外Markdown源码可以直接丢进Git仓库做版本管理。2026年的题目整理完过两年想看看当时某道争议题是怎么解析的翻一下提交记录就清楚了。这种“可追溯”的能力对于长期做竞赛资料积累的人来说价值远超一时的排版美观。提示如果你打算长期整理竞赛资料强烈建议从第一份开始就用Markdown加Git的方式管理后期维护成本会低非常多。3. 一份CSP-J试题Markdown源码的完整结构拆解3.1 文件头与元信息让资料自带“身份证”很多人整理试题直接从第一题开始写结果过段时间自己都忘了这是哪一年的、哪个组别的、答案版本是哪一版。我的习惯是在文件最开头用一段元信息把关键信息固定下来。这部分不追求花哨实用为主# CSP-J 2026 第一轮试题附答案解析 - 赛事CCF CSP-J/S 2026 第一轮认证 - 组别入门级CSP-J - 科目第一轮初赛 - 整理日期2026-09-XX - 答案版本v1.0以官方公布为准 - 整理人XXX - 说明本源码可自由用于学习交流转载请注明出处这段元信息看起来简单但它解决了一个大问题资料的可信度。竞赛答案经常有多个版本流传标注清楚版本和日期别人引用的时候心里有底。我见过太多群里传的“答案”连哪一年哪一组都说不清最后对答案对出一堆乌龙。3.2 单项选择题区块表格化是效率关键单项选择题是整份试题里最规整的部分也是最适合用表格呈现的。但这里有个细节要注意题干较长的题目不适合塞进表格否则表格列宽会被撑得很难看。我的做法是分两层处理——题干短的用表格题干长的用“题干段落选项列表”的形式。先看表格形式适合题干一句话能说完的### 3.2.1 单项选择题第1-8题 | 题号 | 题目 | A | B | C | D | 答案 | |------|------|---|---|---|---|------| | 1 | 下列哪个是C关键字 | class | Class | CLASS | _class | A | | 2 | 二进制1011对应的十进制是 | 9 | 10 | 11 | 12 | C |再看长题干的形式适合带背景描述的题### 3.2.2 单项选择题第9-15题 **第9题** 某同学用冒泡排序对数组 {5, 3, 8, 1} 进行升序排序第一趟排序结束后的结果是 - A. {3, 5, 1, 8} - B. {3, 1, 5, 8} - C. {1, 3, 5, 8} - D. {5, 3, 1, 8} **答案A** **解析** 冒泡排序第一趟从头开始两两比较5和3交换得{3,5,8,1}5和8不换8和1交换得{3,5,1,8}。所以第一趟结束是{3,5,1,8}。这种“题干选项列表答案解析”的三段式结构是我试过很多种排版后觉得最舒服的。选项用无序列表视觉上比表格更宽松适合需要思考的题目解析单独成段方便读者先自己做再看答案。3.3 阅读程序题代码块与判断题的组合拳阅读程序题是CSP-J初赛的重头戏也是Markdown最能发挥优势的地方。这类题的标准结构是一段C代码然后跟着若干判断题正确/错误和选择题。我的组织方式是代码块在前题目在后每题独立成段。### 3.3.1 阅读程序第一题 cpp #include iostream using namespace std; int main() { int n, sum 0; cin n; for (int i 1; i n; i) { if (i % 3 0) sum i; } cout sum endl; return 0; }判断题当输入为10时程序输出为18。 该程序的时间复杂度为 $O(n)$。 选择题若输入为15输出结果是 A. 45 B. 30 C. 60 D. 15答案与解析正确。1到10中3的倍数有3、6、9和为18。正确。循环执行n次每次常数操作。A。1到15中3的倍数有3、6、9、12、15和为45。这里有个实操细节值得说**代码块的语言标注一定要写**。写cpp而不是光写这样在支持语法高亮的阅读器里关键字、注释、字符串会显示不同颜色阅读体验提升非常明显。我早期偷懒不写语言标注结果代码全是黑乎乎一片自己看着都累。 ### 3.4 完善程序题留空与答案的对应关系要清晰 完善程序题的特点是代码里有若干空位通常用下划线或注释标出然后给出选项让考生选择填入。这类题整理时最容易出错的地方是**空位编号和选项编号对不上**。我的做法是在代码里用 // (1) // (2) 这样的注释明确标出空位然后在题目区按编号给出选项。 markdown ### 3.4.1 完善程序第一题 cpp // 求1到n的阶乘之和 #include iostream using namespace std; int main() { int n; long long fact 1, sum 0; cin n; for (int i 1; i n; i) { fact fact * i; // (1) sum sum fact; // (2) } cout sum endl; return 0; }第(1)空选项A. fact fact iB. fact fact * iC. fact iD. fact 1第(2)空选项A. sum sum iB. sum sum * factC. sum sum factD. sum fact答案(1) B (2) C这种结构的好处是读者可以先把代码看一遍自己判断每个空该填什么再往下看选项和答案。空位注释和选项编号一一对应不会出现“第3空的选项跑到第2空下面”这种混乱。 ### 3.5 答案解析区把“为什么”讲透才是好解析 一份试题资料的价值一半在题目一半在解析。我见过很多流传的“答案解析”答案是对的解析就一句话“根据定义可得”这种解析对学习者几乎没有帮助。好的解析应该讲清楚**推理过程**和**易错点**。 以进制转换题为例差的解析是“1011B 11D”好的解析是 二进制转十进制从右往左按位权展开$1\times2^3 0\times2^2 1\times2^1 1\times2^0 8 0 2 1 11$。易错点最右边一位是 $2^0$ 不是 $2^1$很多同学会数错位权。 我在整理时会给每道题标注**难度**和**考点**方便读者针对性复习。比如“考点进制转换”“考点时间复杂度分析”“考点递归”。这样一份试题就不仅是试题还是一份知识点索引。 ## 4. 实操全流程从零整理一份CSP-J试题Markdown ### 4.1 工具准备编辑器、预览与转换三件套 动手之前先把工具配齐能省掉后面大量返工。我的标配是三个东西。 **编辑器**VS Code 或者 Typora。VS Code 免费、插件生态强装一个 Markdown All in One 插件表格自动对齐、快捷键加粗、预览分屏全都有。Typora 是所见即所得写起来更接近Word的体验适合不习惯看源码的人。两个我都用写结构复杂的用VS Code快速记录用Typora。 **预览工具**VS Code 自带 Markdown 预览CtrlShiftVTypora 本身就是预览。如果涉及数学公式VS Code 需要装 Markdown Preview Enhanced 插件它支持 LaTeX 公式渲染看 $O(n^2)$ 这种表达式才正常。 **转换工具**Pandoc。这是Markdown转其他格式的神器一条命令就能把 .md 转成 PDF、Word、HTML。比如转Word bash pandoc csp-j-2026.md -o csp-j-2026.docx转PDF需要先装LaTeX环境稍微麻烦一点但转Word和HTML是开箱即用的。注意Pandoc转Word时Markdown表格会转成Word表格但复杂的嵌套结构可能会走样。建议转换后人工检查一遍表格部分。4.2 建立骨架先搭结构再填内容我整理试题从来不从第一题开始写而是先把整个骨架搭好。骨架就是各级标题和空的内容块具体来说# CSP-J 2026 第一轮试题附答案解析 ## 元信息 待填 ## 一、单项选择题 ### 1-8题 待填 ### 9-15题 待填 ## 二、阅读程序 ### 第一题 待填 ### 第二题 待填 ### 第三题 待填 ## 三、完善程序 ### 第一题 待填 ### 第二题 待填 ## 附录知识点索引 待填先把骨架搭好有个巨大的好处你不会漏题。CSP-J的题量是固定的骨架里每个空对应一道题或一组题填完一个划掉一个最后检查一遍就知道有没有遗漏。我早期直接从头写到尾结果有次漏了阅读程序的第二题发出去被读者指出来非常尴尬。4.3 录入题干与代码几个提效技巧录入环节是最耗时的但有几个技巧能明显提速。技巧一代码用等宽字体核对缩进。C代码的缩进在Markdown里必须用空格不能用Tab不同编辑器Tab宽度不一样会导致显示错乱。VS Code里可以设置“Tab转空格”统一用4个空格。技巧二题干里的特殊符号要转义。Markdown里*_#[]这些符号有特殊含义如果题干里出现比如指针*p、数组下标a[i]要么用反斜杠转义\*要么用行内代码*p包起来。我一般用行内代码既避免转义问题又让符号更醒目。技巧三批量题目用表格单题用段落。前面说过选择题题干短就用表格一次能录好几道题干长就单独成段。不要强行把所有题都塞进表格那样表格会宽到没法看。技巧四答案和解析分开录。先把所有题目和选项录完再统一录答案和解析。这样思路不会被打断而且录答案的时候可以顺便二次核对题目有没有抄错。4.4 答案核对交叉验证与争议题处理答案核对是整份资料质量的生命线。我的流程是自己先做一遍再对照官方答案不一致的题重点标记。自己先做一遍的目的不是证明自己会做而是通过实际解题发现题目本身可能存在的问题比如题干歧义、选项重复、答案有误。CSP-J初赛偶尔会出现争议题这时候处理方式很重要。对于有争议的题我的做法是在解析里同时列出不同理解下的答案并说明争议点在哪里。比如某道关于运算符优先级的题如果不同教材对某个细节定义不同我会写“按C标准答案为X但部分教材表述为Y考试时以官方答案为准。”这样既尊重事实又不会误导读者。交叉验证方面我会至少找两个独立来源的答案对比。如果两个来源一致基本可信如果不一致就回到题目本身重新推导。这个过程虽然费时间但能极大降低出错率。4.5 导出与分发Markdown转Word/PDF的实操整理完成后分发环节要考虑读者的使用习惯。不是所有人都装了Markdown阅读器所以通常我会同时提供三种格式.md源码、.docx文档、.pdf打印版。转Word用Pandocpandoc csp-j-2026.md -o csp-j-2026.docx --reference-doctemplate.docx--reference-doc参数可以指定一个Word模板这样转出来的文档字体、页边距、标题样式都按模板来比默认样式好看很多。我一般会做一个模板标题用黑体、正文用宋体、代码用Consolas转出来直接能打印。转PDF如果不想装LaTeX有个取巧的办法先转成HTML再用浏览器打印成PDF。命令是pandoc csp-j-2026.md -o csp-j-2026.html --standalone --mathjax--mathjax让HTML支持数学公式渲染然后用Chrome打开HTMLCtrlP打印选择“另存为PDF”效果相当不错而且不用折腾LaTeX环境。提示转HTML时加--standalone参数否则生成的HTML没有完整的head和body浏览器打开可能样式全无。5. 常见问题与排查技巧实录5.1 表格显示错乱列宽、对齐与空单元格Markdown表格最常见的问题就是显示错乱。原因通常有三个。原因一单元格内容里有多余的竖线。如果题干里出现|符号比如逻辑或运算会破坏表格结构。解决办法是用\|转义或者用行内代码包起来。原因二表格列数不一致。表头写了7列某一行只写了6个单元格渲染就会出问题。VS Code的Markdown All in One插件有“格式化表格”功能能自动补齐。原因三对齐符号用错。Markdown表格第二行的:---:---:---:分别表示左对齐、居中、右对齐。答案列我一般用居中题干列左对齐。写错了不会报错但显示效果会怪。问题现象可能原因解决办法表格整体错位某行列数不一致用插件格式化补齐单元格竖线消失内容含未转义的|转义为\|或用行内代码对齐混乱对齐符号写错检查第二行:---写法表格过宽题干太长塞进表格改为段落列表形式5.2 代码块缩进丢失与语言高亮失效代码块的问题主要集中在缩进和高亮。缩进丢失通常是因为用了Tab不同阅读器Tab宽度不同看起来就乱了。统一用空格4个空格一级缩进这是最稳的。语言高亮失效一般是两个原因一是没写语言标注二是阅读器不支持该语言。C写cpp或c都行主流阅读器都支持。如果某个阅读器不认代码会显示成纯文本但内容不会丢只是没颜色。还有一个坑代码块里如果有三个连续反引号会提前结束代码块。C里一般不会出现但如果代码注释里写了 就会出问题。解决办法是用四个反引号包裹代码块cpp // 代码内容### 5.3 数学公式不渲染阅读器支持与语法检查 数学公式不渲染九成是阅读器不支持。VS Code原生预览不支持LaTeX必须装Markdown Preview Enhanced。Typora默认支持。GitHub的Markdown渲染支持部分LaTeX但行内公式要用 $...$块级用 $$...$$。 语法方面常见的错误是漏了反斜杠。比如 \log 写成 log渲染出来就是斜体的log而不是正体。希腊字母 \alpha \beta 也要带反斜杠。我建议写完公式后在预览里看一眼确认渲染正常再继续。 ### 5.4 转Word后格式走样样式模板与手动微调 Pandoc转Word后格式走样主要是样式映射的问题。Markdown的 # 标题默认映射到Word的“标题1”但如果你没指定模板Word会用默认样式可能字体、字号都不理想。 解决办法就是前面说的 --reference-doc 指定模板。模板的制作方法是先用Pandoc随便转一个Word出来打开它修改“标题1”“标题2”“正文”“源代码”等样式的字体和段落格式保存为模板以后都用这个模板转。 如果转完还有个别地方走样比如表格边框、代码块背景那就手动在Word里调一下。这种情况不多但遇到了别慌手动改比反复折腾Pandoc参数快。 ### 5.5 独家避坑清单我踩过的那些坑 整理了几届试题坑踩了不少挑几个最有代表性的分享。 **坑一答案版本没标注后期自己都搞混。** 有一次我整理完发出去过了两周有人问“第7题答案怎么和官方不一样”我一查原来我参考的是早期流传的版本官方后来更正了。从那以后元信息里必写“答案版本”和“整理日期”。 **坑二代码里的中文注释导致编码问题。** 早期用GBK编码保存别人用UTF-8打开就乱码。现在统一UTF-8文件头不加BOM兼容性最好。 **坑三表格里放代码导致渲染崩溃。** 有次我把一段带 | 的代码塞进表格单元格整个表格全乱了。后来定了个规矩**代码永远不放进表格**要么单独代码块要么用行内代码。 **坑四解析写得太简略读者看不懂。** 一开始我觉得答案对了就行解析随便写写。结果收到反馈说“解析比题目还难懂”。后来我要求自己每道题的解析都要能让一个没做过这道题的人看懂推理过程。 **坑五文件命名混乱找起来费劲。** 早期文件名有叫“cspj2026.md”的有叫“初赛题.md”的还有叫“新建文本文档.md”的。现在统一格式csp-j-2026-round1-v1.0.md年份、轮次、版本一目了然。 ## 6. 从试题源码到知识资产Markdown资料的长期维护 ### 6.1 用Git管理试题版本一次配置长期受益 把试题Markdown放进Git仓库是我做过的最正确的决定之一。配置很简单 bash git init git add csp-j-2026-round1-v1.0.md git commit -m 整理CSP-J 2026第一轮试题v1.0 之后每次修改比如更正一道题的答案、补充一段解析都提交一次。这样任何时候都能看到“这道题什么时候改的、改了什么、为什么改”。对于需要长期积累的竞赛资料来说这种可追溯性太重要了。 如果不想用命令行VS Code内置了Git图形界面点几下就能提交。GitHub Desktop也很直观。工具不重要重要的是养成版本管理的习惯。 ### 6.2 知识点索引让试题变成复习地图 一份好的试题资料不应该只是“题目的集合”还应该是“知识点的索引”。我在每份试题的最后都会加一个附录把题目按考点分类。 markdown ## 附录知识点索引 | 考点 | 对应题号 | 难度 | |------|----------|------| | 进制转换 | 单选2, 单选6 | 基础 | | 时间复杂度 | 阅读1-2, 完善2-1 | 中等 | | 递归 | 阅读3-1 | 中等 | | 排序算法 | 单选9, 阅读2-3 | 中等 | | 指针与引用 | 单选12 | 较难 | 这个索引的价值在于读者做完题后可以快速定位自己的薄弱环节。比如发现进制转换错了就翻到对应题号重点复习。对于教练来说这个索引也能帮助规划复习课的重点。 ### 6.3 后续扩展方向从单份试题到题库系统 单份试题整理多了自然会想“能不能把它们串起来”。我目前的扩展方向有三个。 **方向一跨年份对比。** 把2023、2024、2025、2026的试题放在一起统计各知识点的出现频率就能看出命题趋势。比如某类题型连续三年出现那明年大概率还会考。 **方向二错题本自动生成。** 如果试题用统一的Markdown结构理论上可以写个脚本根据用户标记的错题自动生成个性化错题本。这个我还在摸索核心难点是题目结构的标准化。 **方向三在线刷题。** Markdown源码转成JSON后可以喂给前端框架做成在线刷题页面。这个对技术栈要求高一些但原理不复杂——把每道题的题干、选项、答案、解析解析成结构化数据即可。 ### 6.4 分享与协作让资料流动起来 最后说个心态问题。我早期整理资料喜欢藏着掖着觉得是自己辛苦弄的。后来发现**分享出去的资料才会变得更好**。别人用了你的资料会给你反馈哪里错了、哪里可以改进这些反馈反过来提升了资料质量。 我现在整理完一份试题会发到几个竞赛交流的地方注明“欢迎指正”。收到的反馈里有指出答案错误的有补充解析思路的还有提供更好排版的。这些反馈让资料越来越完善也让我认识了不少同好。 当然分享的时候要注明来源和整理者尊重彼此的劳动。我在文件头写了“可自由用于学习交流转载请注明出处”既方便传播也保护了自己的署名权。 整理CSP-J试题Markdown这件事看起来是个小项目但认真做下来涉及格式选型、结构设计、工具链配置、版本管理、协作分享一整套流程。这套流程一旦跑通整理任何竞赛资料都能复用。我个人的体会是**工具和格式的选择短期看是效率问题长期看是资产问题**——用Markdown加Git管理起来的资料是能持续增值的知识资产而散落在各处的PDF和图片过两年就找不到了。如果你也在做类似的资料整理不妨从下一份开始试试这套方法。
