1. 从一份试题说起为什么我要把CSP-J初赛题做成Markdown每年CSP-J初赛结束网上就会冒出各种版本的“回忆版”试题和答案。我见过太多这样的场景某个家长群里有人甩出一张模糊的手机截图配文“这是今年CSP-J的题大家看看”某个论坛里有人贴了十几道选择题排版乱得连题号都对不上还有人把答案和题目混在一起想对个答案得来回翻好几屏。我自己带过几届信息学入门班的学生每年这个时候都要花大量时间帮他们找靠谱的真题和解析找到之后还得重新排版、校对、补充知识点才能发给学生用。所以从几年前开始我就养成了一个习惯每年CSP-J初赛结束后自己动手整理一份完整的试题文档用Markdown格式写包含题目、选项、答案、逐题解析以及每道题对应的知识点标注。今年这份“CSP-J2026第一轮试题”也是这么来的。Markdown的好处在于它纯文本、跨平台、结构清晰用任何编辑器打开都能看转成PDF、Word、网页都不费劲而且源码可以直接分享给其他人二次编辑。这篇文章不是简单地贴一份试题出来而是想把我整理这份试题的完整思路、方法、踩过的坑以及Markdown在试题整理这个场景下的具体用法从头到尾讲清楚。如果你是一位信息学教练、一位正在备考CSP-J的学生、或者一位想帮孩子整理学习资料的家长这篇文章应该能给你一些直接能用的东西。即使你只是对Markdown排版感兴趣里面关于表格、公式、代码块、图片路径的处理经验也值得一看。2. 整体设计思路一份试题文档应该长什么样2.1 试题文档的核心需求拆解在动手之前我先想清楚了一份“好用的试题文档”到底需要满足哪些需求。这不是拍脑袋决定的而是从实际使用场景倒推出来的。第一题目和答案必须分离但可对照。学生做题的时候不能看到答案对答案的时候又要能快速找到。我的做法是在每道题后面用引用块标注答案和解析这样学生做题时可以用阅读器的折叠功能把引用块收起来对答案时再展开。第二每道题要有知识点标注。CSP-J初赛考的知识点其实是有规律的比如进制转换、排序算法、数据结构基础、简单图论、组合数学等。标注知识点之后学生就能按知识点归类复习而不是盲目刷题。第三解析要讲清楚“为什么”。很多网上的答案解析只写“选B”然后一句话带过。这种解析对学生帮助很小。我的解析会写清楚每个选项为什么对、为什么错涉及到的知识点是什么有时候还会补充一个简单的例子。第四格式要统一且可复用。题号、选项、答案、解析的格式必须一致这样不管是打印出来还是转成其他格式都不会乱。Markdown的标题层级和列表语法天然适合做这件事。第五源码要能直接分享和二次编辑。我用的是纯Markdown没有依赖任何私有格式。别人拿到源码后用Typora、VS Code、Obsidian都能打开想改哪里改哪里。2.2 为什么选Markdown而不是Word或PDF这个问题我被问过很多次。Word和PDF当然也能做试题文档但它们有几个绕不开的问题。Word的问题是格式容易跑偏。你在一台电脑上排好的版换一台电脑打开可能就变了发给别人之后对方如果用的是WPS或者不同版本的Word行距、缩进、字体都可能出问题。而且Word文件是二进制格式想用Git做版本管理几乎不可能。PDF的问题是编辑成本高。PDF适合最终分发但不适合协作和修改。如果发现一道题的解析写错了改起来很麻烦。Markdown的优势在于纯文本任何编辑器都能打开格式和内容分离改内容不会影响格式天然支持标题层级、列表、表格、代码块可以方便地转换成PDF、Word、HTML可以用Git做版本管理每次修改都有记录。当然Markdown也有它的局限比如复杂的排版比如多栏布局、精确的页边距控制做不了。但对于试题文档这种以文字为主的内容Markdown完全够用而且效率高得多。2.3 文档结构设计我最终的文档结构是这样的一级标题试卷名称和年份二级标题大题分类单项选择题、阅读程序题、完善程序题三级标题每道题题目正文用普通段落选项用无序列表答案和解析用引用块知识点标注用加粗文字这个结构的好处是层级清晰用任何Markdown阅读器打开都能自动生成目录想跳到哪道题直接点目录就行。转成PDF的时候标题层级也会自动变成书签。3. 核心细节解析Markdown试题排版的几个关键技巧3.1 题号和选项的排版规范题号我用的是三级标题比如“### 3.1 第1题”。这样每道题在目录里都能看到方便快速定位。选项用无序列表每个选项一行前面加粗选项字母。这里有个细节Markdown的无序列表默认用“-”或者“*”但如果你在选项里用了“-”而选项内容本身又包含“-”就可能出现嵌套列表的歧义。我的做法是选项统一用“-”选项内容里如果出现“-”就用中文破折号“——”代替避免解析混乱。还有一个坑如果选项内容比较长换行之后Markdown可能会把它当成新的段落。解决办法是在选项内容后面加两个空格再换行或者直接用一行写完。我一般选择一行写完因为CSP-J的选项通常不会太长。3.2 答案和解析的引用块处理答案和解析我用引用块来标注。引用块在大多数Markdown阅读器里都有明显的视觉区分而且可以折叠。比如答案B解析这道题考查的是二进制转十进制。二进制数1011转换为十进制的方法是1×2³ 0×2² 1×2¹ 1×2⁰ 8 0 2 1 11。所以选B。知识点进制转换这里要注意的是引用块里的换行需要用“”开头否则会被当成普通段落。如果解析内容比较长分成多个段落每个段落前面都要加“”。另外我在答案和解析之间用了一个空引用行就是只有“”没有内容这样视觉上更清晰。有些Markdown阅读器会把连续引用行合并成一个块加空行可以强制分开。3.3 代码块和数学公式的处理CSP-J初赛里有一些题目涉及代码阅读比如阅读程序题和完善程序题。这些代码必须用代码块包裹否则缩进和特殊字符会乱。我用的是三个反引号加语言标识比如#include iostream using namespace std; int main() { int a, b; cin a b; cout a b endl; return 0; }语言标识写“cpp”可以让编辑器自动做语法高亮阅读体验好很多。如果代码里有反引号就用四个反引号包裹。数学公式方面CSP-J初赛涉及的不多但偶尔会有一些简单的计算。我用的是行内公式比如“2³”直接写成“2^3”或者用Unicode上标。Markdown本身不支持LaTeX公式但很多阅读器比如Typora、VS Code加插件支持。如果你的阅读器不支持用普通文本写也能看懂。3.4 表格在知识点汇总中的应用试题文档里有一个很有用的部分知识点汇总表。我把每道题的知识点、难度、分值整理成表格方便学生按知识点复习。题号知识点难度分值1进制转换易22排序算法中23数据结构基础中24简单图论难2Markdown表格的语法是用“|”分隔列用“-”分隔表头和数据。这里有个坑如果单元格内容里包含“|”需要用“|”转义否则表格会乱。我一般避免在表格内容里用“|”如果实在要用就用“/”代替。表格的列宽Markdown本身控制不了但大多数阅读器会自动调整。如果某一列内容特别长可以考虑拆成多个表格或者把长内容放到表格外面的段落里。3.5 图片路径和资源管理试题文档里有时候会有图片比如流程图、示意图。Markdown插入图片的语法是。图片路径有两种写法相对路径和绝对路径。相对路径是相对于Markdown文件的位置比如images/fig1.png绝对路径是从根目录开始比如/Users/xxx/images/fig1.png。我的建议是用相对路径并且把图片放在和Markdown文件同一个目录下的images文件夹里。这样整个文件夹打包发给别人图片也能正常显示。如果用绝对路径别人打开你的文件时图片就会丢失。还有一个坑图片文件名不要用中文和空格否则在某些阅读器里可能显示不出来。我用的是英文加数字比如fig1.png、fig2.png。4. 实操过程从零整理一份CSP-J试题文档4.1 环境准备和工具选型整理试题文档不需要太复杂的工具我用的是一台普通笔记本电脑操作系统不限。核心工具就两个一个Markdown编辑器一个浏览器用来查资料和预览。Markdown编辑器我试过很多款最后固定在Typora和VS Code之间切换。Typora的优点是所见即所得写起来很顺手适合快速整理VS Code的优点是插件丰富可以用Markdown Preview Enhanced做更复杂的预览还可以用Git做版本管理。如果你刚开始用Markdown我建议从Typora入手它的学习曲线最平缓。下载安装之后新建一个.md文件直接开始写就行。Typora会自动把Markdown语法渲染成好看的格式你不需要记太多语法。如果你已经比较熟悉Markdown或者需要做版本管理那就用VS Code。安装“Markdown All in One”插件可以自动生成目录、快捷键加粗、预览等。再安装“Markdown Preview Enhanced”支持数学公式、流程图、导出PDF等功能。4.2 试题内容的收集和校对试题内容的来源主要有几个官方发布的真题、考生回忆版、网上流传的版本。我的做法是先用回忆版整理出初稿然后对照多个版本交叉校对遇到不一致的地方就查资料或者问学生。校对的时候要特别注意几个地方题号是否连续、选项是否有遗漏、答案是否有争议、解析是否有错误。我一般会校对三遍第一遍对照原始版本第二遍自己从头做一遍题第三遍让学生做一遍看有没有歧义。这里有个经验CSP-J初赛的选择题有时候会有“以下哪个选项不正确”这种问法整理的时候要特别小心别把“不正确”看成“正确”。我见过好几个版本的试题在这类题目上出错。4.3 Markdown源码的编写和格式化内容校对完之后就开始写Markdown源码。我的编写顺序是先写标题和结构再填题目内容最后加答案和解析。标题和结构用二级标题和三级标题搭好框架比如## 1. 单项选择题 ### 1.1 第1题 题目内容... - A. 选项A - B. 选项B - C. 选项C - D. 选项D **答案B** **解析** ... **知识点** ... ### 1.2 第2题 ...题目内容用普通段落选项用无序列表答案和解析用引用块。这个格式统一之后写起来很快而且不容易出错。写完之后我会用编辑器的格式化功能统一格式。Typora有“格式化文档”功能VS Code可以用Prettier插件。格式化之后缩进、空行、列表符号都会统一看起来更整洁。4.4 导出和分发Markdown源码写完之后可以根据需要导出成不同格式。导出PDFTypora直接支持“文件→导出→PDF”。VS Code可以用Markdown Preview Enhanced的“Chrome (Puppeteer)”导出效果更好。导出之前记得在设置里调整页边距和字体大小否则默认的排版可能太挤。导出WordTypora支持导出Word但格式可能会有一些偏差。如果需要更精确的控制可以用Pandoc命令行工具比如pandoc input.md -o output.docx --reference-doctemplate.docx导出HTMLMarkdown可以直接导出HTML用浏览器打开就能看。如果要在网页上发布可以把HTML嵌入到网页里。分发的时候我一般会同时提供Markdown源码和PDF版本。Markdown源码给需要二次编辑的人PDF给只需要阅读的人。如果文件比较大可以打包成zip里面包含Markdown文件、图片文件夹和PDF。5. 常见问题与排查技巧实录5.1 Markdown表格转换Excel的坑有时候需要把试题里的表格转到Excel里做统计。Markdown表格转Excel最简单的方法是用在线工具比如“Markdown Table to Excel”。但这里有几个坑。第一个坑表格里的换行。Markdown表格的单元格里不能直接换行如果内容太长只能写在一行里。转到Excel之后所有内容都在一个单元格里看起来很难受。解决办法是在Markdown里用br标签强制换行转到Excel之后会变成单元格内的换行。第二个坑特殊字符。如果表格内容里有“|”、“”、“”、“”这些字符转到Excel之后可能会乱码或者被截断。解决办法是提前转义或者用其他字符代替。第三个坑合并单元格。Markdown表格不支持合并单元格如果原表格有合并单元格转到Excel之后需要手动调整。5.2 Markdown换行和空行的处理Markdown的换行规则和Word不一样很多人第一次用会不习惯。在Markdown里一个回车不会产生新段落只是换行。要产生新段落需要两个回车也就是中间空一行。如果只想换行不想分段可以在行尾加两个空格再回车。这个规则在写试题解析的时候特别重要。如果解析分几段每段之间要空一行如果只是换行行尾加两个空格。还有一个坑引用块里的换行。引用块里的内容每行前面都要加“”否则会被当成普通段落。如果引用块里要空行就写一个只有“”的行。5.3 图片路径不对的排查方法图片显示不出来是Markdown新手最常见的问题。排查方法很简单第一步检查图片路径是否正确。相对路径是相对于Markdown文件的位置不是相对于你当前打开的文件的位置。比如你的Markdown文件在/docs/test.md图片在/docs/images/fig1.png那么路径应该是images/fig1.png。第二步检查文件名大小写。有些操作系统比如Linux区分大小写Fig1.png和fig1.png是两个不同的文件。第三步检查图片格式。Markdown支持常见的图片格式比如PNG、JPG、GIF。如果图片是WebP或者HEIC有些阅读器可能不支持。第四步检查阅读器设置。有些阅读器默认不加载本地图片需要在设置里开启。5.4 常见问题速查表问题可能原因解决方法表格显示错乱单元格内容包含“”图片不显示路径错误或文件名大小写不对检查相对路径和文件名引用块不换行引用块内换行没加“”每行前面加“”代码块没有高亮没写语言标识在三个反引号后加语言名导出PDF排版乱页边距或字体设置不对在导出设置里调整列表嵌套混乱缩进不一致统一用两个空格缩进5.5 几个独家避坑技巧第一个技巧用Git做版本管理。每次修改试题文档都提交一次Git记录。这样如果改错了可以随时回退到之前的版本。GitHub Desktop或者VS Code自带的Git功能都很方便。第二个技巧用模板文件。把试题文档的格式做成模板每次整理新试题的时候直接复制模板改内容就行。这样格式永远统一不用每次都重新调。第三个技巧用脚本自动检查。写一个简单的Python脚本检查题号是否连续、选项是否有四个、答案是否在选项范围内。这样可以避免很多低级错误。import re def check_questions(text): questions re.findall(r### \d\.\d 第(\d)题, text) for i, q in enumerate(questions): if int(q) ! i 1: print(f题号不连续第{i1}个题号是{q}) print(f共找到{len(questions)}道题) with open(test.md, r, encodingutf-8) as f: check_questions(f.read())这个脚本很简单但很实用。我每次整理完试题都会跑一遍确保没有漏题或者题号错误。6. 知识点标注与复习策略6.1 CSP-J初赛知识点分类CSP-J初赛的知识点大致可以分为以下几类计算机基础知识计算机组成、操作系统、网络基础、进制转换程序设计基础变量、数据类型、运算符、控制结构数据结构数组、链表、栈、队列、树、图算法排序、查找、递归、贪心、动态规划、图论数学基础组合数学、概率统计、数论基础我在整理试题的时候会给每道题标注一个或多个知识点。标注的方式是在解析后面加一行“知识点进制转换、二进制”。6.2 按知识点归类复习的方法标注完知识点之后就可以做归类复习了。我的做法是第一步把所有题目按知识点分组。比如把所有考“排序算法”的题放在一起把所有考“进制转换”的题放在一起。第二步统计每个知识点的题目数量和分值。这样可以知道哪些知识点是重点哪些是次要的。第三步针对薄弱知识点做专项练习。比如某个学生“图论”比较弱就把所有图论题找出来集中做一遍然后看解析。第四步定期回顾。每隔一段时间把之前做错的题再拿出来做一遍看看是否真的掌握了。6.3 用Markdown做知识点索引Markdown的链接语法可以用来做知识点索引。比如在文档开头加一个索引区## 知识点索引 - [进制转换](#进制转换) - [排序算法](#排序算法) - [数据结构基础](#数据结构基础)然后在对应知识点的地方加锚点### 进制转换 ...这样点击索引就能跳到对应位置。不过Markdown的锚点语法在不同阅读器里支持程度不一样Typora和VS Code支持得比较好有些在线Markdown阅读器可能不支持。如果阅读器不支持锚点可以用搜索功能代替。按CtrlF搜索知识点名称也能快速定位。7. 从试题整理到教学应用7.1 用试题文档做课堂练习整理好的试题文档可以直接用来做课堂练习。我的做法是第一步把试题文档导出成PDF打印出来发给学生。第二步给学生30-40分钟做题不允许查资料。第三步收卷后快速批改统计每道题的正确率。第四步针对正确率低的题目在课堂上重点讲解。第五步把解析发给学生让他们对照自己的答案看看哪里理解错了。这个流程我用了好几届效果很好。关键是试题文档的格式要清晰学生做题的时候不会因为排版问题分心。7.2 用Markdown做错题本学生可以用Markdown做自己的错题本。格式可以这样## 错题本 ### 2026年第3题 **题目** ... **我的答案** A **正确答案** B **错误原因** 把二进制转十进制算错了忘了从2⁰开始算。 **知识点** 进制转换 **复习日期** 2026-10-15这样每道错题都有记录复习的时候一目了然。而且Markdown格式方便搜索想找某个知识点的错题直接搜索知识点名称就行。7.3 用Git做教学资料版本管理如果你是一位教练有多年的教学资料用Git做版本管理会非常方便。每次更新试题、解析、课件都提交一次Git记录。这样可以随时回退到之前的版本可以看到每次修改的内容可以多人协作不会冲突可以同步到多个设备我用的是GitHub私有仓库把所有的教学资料都放在里面。每次上课前从仓库拉取最新版本每次课后把新的资料提交上去。几年下来积累了几百次提交记录想找任何一份历史资料都能找到。8. 我个人的一些经验和建议整理CSP-J试题这件事我做了好几年踩过不少坑也积累了一些经验。这里分享几条我觉得最有用的。第一条格式统一比内容精美更重要。一开始我总想把试题文档做得特别好看加各种颜色、图标、边框。后来发现格式统一才是最重要的。学生看的是内容不是排版。格式统一之后阅读体验自然就好。第二条解析要写给学生看不是写给自己看。我刚开始写解析的时候总是不自觉地用一些专业术语觉得这样显得专业。后来发现学生根本看不懂。现在我的解析尽量用大白话能用例子就用例子能画图就画图。第三条知识点标注要具体不要笼统。写“算法”太笼统了写“排序算法中的冒泡排序”才具体。学生复习的时候需要知道具体考的是哪个知识点才能有针对性地查漏补缺。第四条定期更新试题文档。CSP-J的考纲和题型每年都会有一些变化试题文档也要跟着更新。我每年都会把新的试题加进去把过时的内容删掉保持文档的时效性。第五条分享出去让别人用。我整理的试题文档除了自己用也会分享给其他教练和学生。分享的过程中会收到很多反馈有的指出错误有的提出建议这些反馈帮助我不断改进文档质量。最后再分享一个小技巧如果你用Typora可以在设置里开启“自动保存”和“自动编号”。自动保存可以避免意外丢失内容自动编号可以让标题层级自动生成编号省去手动编号的麻烦。VS Code的话可以用“Markdown All in One”插件的“自动编号”功能效果类似。这份CSP-J2026第一轮试题的Markdown源码我放在了个人仓库里包含完整的题目、答案、解析和知识点标注。如果你需要可以拿去直接用也可以根据自己的需要修改。整理试题这件事看起来简单但要做好需要耐心和细心。希望我的经验能帮你少走一些弯路。