用途:把本地 Hugo 站点内容转成标准 Markdown,适用于需依据仓库真实配置推导输出的场景,而非凭通用 Hugo 知识猜测。
主要能力:先清点站点规则(hugo.toml 等配置、archetypes、data、layouts/_shortcodes、layouts/_markup、content 等),再逐文件或逐节转换。保留 YAML front matter 及 title、description、date、draft、aliases、slug、url、weight 等字段,规范化大小写;解析内部链接;阅读本地短代码实现后再替换或物化;保留块属性与代码围栏语义;对无法安全复现的短代码降级为明确说明文字;对记录 Hugo 语法的字面示例保持原样。
使用方式:先运行 python3 scripts/inventory_hugo_rules.py --site-root /path/to/hugo-site 清点规则;转换前阅读 references/conversion-workflow.md;转换后用 python3 skills/hugo-to-markdown/scripts/check_standard_markdown.py --root /path/to/output 校验残留的 Hugo 专属语法。
适用场景:Hugo 文档站点批量转 Markdown,含自定义短代码、渲染钩子、页面资源、include 片段组合的内容。
限制:不执行 Hugo 模板、短代码或 Go 模板表达式;未经用户明确要求不运行 hugo、npm install 等安装或联网步骤;读写限制在声明的站点根与输出根,拒绝路径穿越与符号链接逃逸;不得泄露本地绝对路径、密钥或环境变量;无法确定性复现时降级为显式 Markdown 说明。缺失事实暂未提供。