网站Markdown文章无法正常显示及404错误求助

• 检查文章Front Matter的正确性
  复制能正常显示的旧文章的Front Matter，和新文章逐一对比：

  • 确保必填字段（比如layout、title）存在且拼写正确，比如不要把layout: post写成layout: posts
  • 严格遵循YAML语法：冒号后必须加空格，不能用tab缩进（只能用空格），字符串引号要配对，键值对末尾不能加逗号（比如你之前加的timezone: America/New_York,里的逗号就是语法错误）

• 验证文章命名规则
  Jekyll默认要求文章文件名格式为YYYY-MM-DD-文章标题.md，确保新文章的命名和旧文章完全一致：

  • 年份必须是4位数字，日期用短横线分隔，不能用斜杠或其他符号
  • 标题部分不要包含特殊字符（比如中文全角符号），避免URL生成异常

• 恢复config.yml的正确配置
  撤销你之前的两处修改：

  • 把timezone: America/New_York,改为timezone: America/New_York（去掉末尾逗号）
  • 把paginate_path: blog/page:num/ 改回paginate_path: /blog/:num/（补开头的斜杠，保持和Jekyll默认及旧配置一致）
    修改后重新构建网站，测试是否恢复正常

• 本地构建查看错误日志
  在本地用jekyll serve启动服务，观察终端输出的日志：

  • 如果有Front Matter解析错误、文章生成失败的提示，直接根据提示修复问题
  • 本地访问首页，测试文章链接是否能正常打开，排除线上部署的额外问题

• 排查文章内容的语法问题
  把新文章的内容逐步替换成旧文章的内容，每次替换后重新构建测试：

  • 定位是哪段内容导致的解析失败，常见问题包括未闭合的Markdown标签、错误的代码块格式、特殊字符转义问题

• 检查自定义permalink配置
  如果旧文章使用了自定义permalink字段，新文章必须保持相同格式：

  • 比如旧文章是permalink: /blog/:year/:month/:day/:title/，新文章要沿用该格式，确保生成的URL和首页链接匹配，避免404

内容的提问来源于stack exchange，提问作者user24090662