目录功能踩坑记录：代码块中的 # 号被误识别为标题的解决方案

本文详细记录了在 Next.js 博客项目中，针对详情页加载慢、主线程阻塞等性能瓶颈，通过将 Markdown 解析迁移到构建/服务端阶段，实现性能大幅提升的全流程分析和真实优化效果。包括问题发现、技术对比、实施过程、遇到的难题和最终成效对比。

记录博客系统中代码块内容错位显示的完整排查和修复过程，从Playwright自动化测试发现问题，到采用分阶段内容块处理方案彻底解决，包含根因分析、市场调研和最佳实践总结。

详细记录将博客系统中自定义正则表达式解析器重构为基于remark的成熟方案的完整过程，包含技术选型分析、实现细节、问题排查和Playwright验证，为同类项目提供实战参考。

记录一次因为混淆开发模式和生产模式导致的性能测试"乌龙"事件，深入分析 Next.js 中 dev 模式与 build 模式的本质差异，以及如何正确进行本地生产环境测试。