This is a beta course, so its structure, chapters, and examples may continue to change.
《Markdown 从入门到精通》读者视角问题清单
检查时间：2026-06-04
检查范围：content/courses/en/markdown 下的课程入口、章节索引和主要 MDX 课文。以下问题从读者学习体验出发整理，优先级越高，越可能直接导致读者中断阅读、误解知识或不信任课程。
P0：会直接阻断学习的问题
25 个正文页接近空骨架，读者点进去没有可学习内容
受影响文件：
content/courses/en/markdown/advanced/escaping.mdxcontent/courses/en/markdown/advanced/footnotes.mdxcontent/courses/en/markdown/advanced/html.mdxcontent/courses/en/markdown/advanced/math.mdxcontent/courses/en/markdown/basics/editors.mdxcontent/courses/en/markdown/basics/what-is-markdown.mdxcontent/courses/en/markdown/basics/why-markdown.mdxcontent/courses/en/markdown/code/code-blocks.mdxcontent/courses/en/markdown/code/inline-code.mdxcontent/courses/en/markdown/code/syntax-highlighting.mdxcontent/courses/en/markdown/links-images/auto-links.mdxcontent/courses/en/markdown/links-images/images.mdx- 另有 13 个同类文件未列出。
这些页面基本只剩 frontmatter、标题、组件或极少量说明，无法承接课程路径。读者会以为内容未完成，尤其当它们出现在章节中部时，会直接中断学习。
建议：补齐正文、例题、阶段小结和必要图示；若短期无法补齐，先从导航中隐藏或标注为未完成。
P1：结构和学习路径问题
8 个章节索引页缺少导读
受影响文件：
content/courses/en/markdown/advanced/index.mdxcontent/courses/en/markdown/basics/index.mdxcontent/courses/en/markdown/code/index.mdxcontent/courses/en/markdown/index.mdxcontent/courses/en/markdown/links-images/index.mdxcontent/courses/en/markdown/lists-quotes/index.mdxcontent/courses/en/markdown/tables/index.mdxcontent/courses/en/markdown/text-formatting/index.mdx
这些索引页通常只有标题或封面组件，没有说明本章要解决什么问题、子章节顺序、前置知识或读完后的能力目标。读者进入章节入口时会缺少方向。
建议：每个章节索引至少补“本章问题、学习目标、建议阅读顺序、可跳过/需预备的内容”。如果只是导航占位，建议暂时隐藏。
课程首页缺少读者路径说明
受影响文件：
content/courses/en/markdown/index.mdx
首页正文信息量偏少，读者很难判断课程适合谁、需要哪些基础、应该按什么路线学习，以及学完能解决什么问题。
建议：补充适合读者、前置知识、章节地图、推荐路径和最终学习产出。
8 个同级页面共享相同 order
受影响文件：
content/courses/en/markdown/basics/index.mdxcontent/courses/en/markdown/basics/what-is-markdown.mdxcontent/courses/en/markdown/links-images/auto-links.mdxcontent/courses/en/markdown/links-images/index.mdxcontent/courses/en/markdown/lists-quotes/index.mdxcontent/courses/en/markdown/lists-quotes/nested-lists.mdxcontent/courses/en/markdown/text-formatting/index.mdxcontent/courses/en/markdown/text-formatting/paragraphs.mdx
同一目录下多个页面使用相同 order，导航可能依赖文件名或构建器默认顺序，导致读者看到的章节顺序不稳定。
建议：同级页面使用唯一递增 order；若需要章节级排序和文章级排序，拆分字段或明确排序策略。
P2：阅读体验问题
暂未发现明显的阅读体验 P2 问题。
建议修复顺序
- 补齐或隐藏空骨架正文页。
- 补课程首页和章节索引导读。
- 统一同级页面 order。