markdown-frontmatter-auto-date

在构建基于 Jekyll 或 Hugo 的博客时，标准化的 Front Matter 格式（尤其是 date: 字段）至关重要。本文介绍一个两步自动化方案：使用 Python 提取正文日期并插入到 YAML Front Matter 中，然后使用 Shell 脚本按 date: 重命名所有 Markdown 文件。

1. 目标

  • 自动从 Markdown 正文中提取 YYYY/MM/DD，YYYY-MM-DD格式的日期
  • 将其转为标准格式 YYYY-MM-DD
  • 添加或更新 date: 字段到 Front Matter 中
  • 根据 date: 字段重命名文件为 YYYY-MM-DD-filename.md

2. 使用 Python 脚本自动更新 date: 字段

1. 脚本说明

  • 搜索正文中的第一个日期（格式如 2024/5/9，2024-5-9）
  • 格式化为 2024-05-09
  • 写入（或更新）YAML Front Matter 中的 date: 字段

2. 脚本代码（update_date.py）

import re
import sys

filename = sys.argv[1]

with open(filename, 'r', encoding='utf-8') as f:
    content = f.read()

# 找正文第一次出现 YYYY/MM/DD 格式的日期，没有跳过
date_match = re.search(r'(\d{4})/(\d{1,2})/(\d{1,2})', content)
if not date_match:
    print(f"No date found in {filename}, skipped")
    sys.exit(0)

yyyy, mm, dd = date_match.groups()
date_str = f"{yyyy}-{int(mm):02d}-{int(dd):02d}"

# 判断是否有 Front Matter，分割
if content.startswith('---'):
    parts = content.split('---', 2)
    fm = parts[1]
    body = parts[2]

    # 替换或新增 date: 字段
    if re.search(r'^date:\s*.*$', fm, re.MULTILINE):
        fm_new = re.sub(r'^date:\s*.*$', f"date: {date_str}", fm, flags=re.MULTILINE)
    else:
        fm_new = fm.strip() + f"\ndate: {date_str}\n"

    new_content = f"---{fm_new}---{body}"

else:
    # 没有 Front Matter，新增一个
    new_content = f"---\ndate: {date_str}\n---\n{content}"

with open(filename, 'w', encoding='utf-8') as f:
    f.write(new_content)

print(f"Updated {filename} with date: {date_str}")

3. Shell 脚本按 date: 字段批量重命名文件

1. 脚本代码（rename_by_date.sh）

#!/bin/bash

for file in *.md; do
  date_prefix=$(grep -m1 '^date:' "$file" | sed -E 's/date:[[:space:]]*([0-9]{4}-[0-9]{2}-[0-9]{2}).*/\1/')
  if [[ -n "$date_prefix" ]]; then
    new_name="${date_prefix}-$file"
    mv "$file" "$new_name"
    echo "Renamed $file → $new_name"
  fi
done

2. 效果示例

原始文件名 文件内容中的日期字段 执行后文件名
article.md date: 2024/06/20 2024-06-20-article.md

4. 使用方法（终端中执行）

cd ~/Desktop/drafts  # 切换到你的 Markdown 文件夹
# 逐个文件调用 Python 脚本
for file in *.md; do python3 ../update_date.py "$file"; done
# 然后执行重命名脚本
bash rename_by_date.sh