Markdown 渲染器重构实战：从自定义正则到成熟库的技术升级之路

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

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

记录MermaidFlow项目中右侧Mermaid预览区域高度不匹配的完整调试过程。从使用Playwright进行页面检查、错误的初始判断，到最终精确定位iframe固定高度问题并实施修复的技术实战经验。

记录一次目录功能的重大 bug 修复过程：代码块中的 # 号被错误识别为标题。从问题发现到深度调研，再到最终的 AST 解析方案，详细分析了 Markdown 解析的技术细节和最佳实践。