Next.js 入门指南：从零开始构建现代Web应用

记录为个人博客添加目录功能的完整开发过程，包括技术选型、实际代码实现和遇到的问题解决。基于 Next.js + TypeScript + Intersection Observer 的实战经验。

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

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

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