YAML frontmatter がエラーを出さずに値を書き換える条件を確かめました

highlights:
  - 判定できる: 切り分け方がわかる

{'highlights': [{'判定できる': '切り分け方がわかる'}]}

highlights:
  - "判定できる: 切り分け方がわかる"

const item = { "判定できる": "切り分け方がわかる" };
 
console.log(`${item}`);                       // [object Object]
console.log([item, "正しい項目"].join(" / ")); // [object Object] / 正しい項目

#!/usr/bin/env python3
"""Markdown の frontmatter を全数パースし、落ちるものと黙って型が変わるものを分けて報告する。"""
import sys, glob, yaml
 
# キー名 -> 期待する Python 型
EXPECTED = {
    "title": str,
    "description": str,
    "tags": list,
    "highlights": list,
}
# 中身まで str であることを求めるリスト型キー
STR_LIST_KEYS = {"tags", "highlights"}
 
def split_frontmatter(text):
    if not text.startswith("---"):
        return None
    end = text.find("\n---", 3)
    if end == -1:
        return None
    return text[3:end]
 
def check(path):
    problems = []
    block = split_frontmatter(open(path, encoding="utf-8").read())
    if block is None:
        return [("NO_FRONTMATTER", "先頭に --- で囲まれたブロックがありません")]
    try:
        data = yaml.safe_load(block)
    except yaml.YAMLError as e:
        line = getattr(getattr(e, "problem_mark", None), "line", None)
        where = f"{line + 2} 行目付近" if line is not None else "位置不明"
        return [("PARSE_ERROR", f"{type(e).__name__}: {where}")]
    if not isinstance(data, dict):
        return [("NOT_A_MAP", f"最上位が {type(data).__name__} です")]
    for key, want in EXPECTED.items():
        if key not in data:
            continue
        got = data[key]
        if not isinstance(got, want):
            problems.append((
                "TYPE_DRIFT",
                f"{key} は {want.__name__} を期待しましたが {type(got).__name__} でした",
            ))
            continue
        if key in STR_LIST_KEYS:
            for i, item in enumerate(got):
                if not isinstance(item, str):
                    problems.append((
                        "SILENT_MAP",
                        f"{key}[{i}] が {type(item).__name__} です。"
                        f"未クォートのコロンが原因です -> {item}",
                    ))
    return problems
 
def main(paths):
    bad = 0
    for path in sorted(paths):
        problems = check(path)
        if not problems:
            print(f"OK          {path}")
            continue
        bad += 1
        for kind, detail in problems:
            print(f"{kind:<12}{path}: {detail}")
    print(f"\n検査 {len(paths)} 件 / 問題あり {bad} 件")
    return 1 if bad else 0
 
if __name__ == "__main__":
    targets = sys.argv[1:] or glob.glob("content/**/*.md", recursive=True)
    sys.exit(main(targets))

PARSE_ERROR content/at.md: ScannerError: 3 行目付近
PARSE_ERROR content/hard.md: ScannerError: 3 行目付近
OK          content/ok.md
SILENT_MAP  content/silent.md: highlights[0] が dict です。未クォートのコロンが原因です -> {'判定できる': '切り分け方がわかる'}
PARSE_ERROR content/tab.md: ScannerError: 3 行目付近
 
検査 5 件 / 問題あり 4 件