当您需要将 Hugo 文档网站和 Hugo 管理的内容转换为标准 Markdown 时使用此技能。当代理需要检查本地 Hugo 仓库、读取 hugo.toml 或配置文件、content/、archetypes/、layouts/_shortcodes/、layouts/_markup/ 及相关文档内容，然后生成 Markdown 时使用。

当必须从本地 Hugo 站点生成 Markdown 输出，而不能根据通用 Hugo 知识进行推测时，请使用此技能。转换规则是 Hugo 官方行为与存储库自身的配置、短代码模板、渲染钩子、原型和内容约定的组合。

将仓库自身的 Hugo 配置和模板视为主要规则集。对于任何正在转换的网站，请检查用户提供的网站根目录中的这些规则源：

还要阅读任何定义短代码、前置内容、捆绑包、资源和渲染钩子行为的本地文档。

如果仓库在本地覆盖了内置的 Hugo 默认设置，不要假设使用内置默认值。

1. 在转换文件之前清点网站库存

始终首先检查站点级别的规则。

python3 scripts/inventory_hugo_rules.py --site-root /path/to/hugo-site

python3 skills/hugo-to-markdown/scripts/inventory_hugo_rules.py \
  --site-root /path/to/your-hugo-site

此库存步骤是批量工作的强制性步骤。它识别：

2. 根据仓库规则转换，而不是通用启发式方法

在修改文件之前，请先阅读 references/conversion-workflow.md。然后：

4. 仔细应用 Hugo 特定的正文规则

许多 Hugo 文档网站使用复杂的本地行为。请注意这些常见模式：

在转换包含 Hugo 语法的任何文件之前，请先阅读 references/shortcodes-and-render-hooks.md。

转换后，扫描生成的 Markdown 文件，查找残留的仅适用于 Hugo 的语法。

python3 skills/hugo-to-markdown/scripts/check_standard_markdown.py \
  --root /path/to/output

如果验证器报告代码区块外有活动的 Hugo 语法，请执行以下操作之一：

不要默默地发布未解决的 {{}}、{{% ... %}} 或 Go 模板表达式。

6. 当完全实现不安全时，明确降级

如果一个短代码依赖于构建时数据、生成的示例或你无法从本地仓库快照确定性解析的外部源文件，请用明确的 Markdown 注释替换它。

使用简短、乏味的格式，例如：

不要留下空链接、损坏的表格单元格或没有解释的删除内容。

在转换显示类似模式的 Hugo 文档站点时，请使用这些事实：

前言部分映射、常见内容惯例和字面示例处理。

Hugo 简码表示法、文档网站自定义简码以及渲染钩子影响。

链接解析、资产、验证和残留物分类处理。

扫描一个 Hugo 网站并生成规则清单。

检测 Markdown 输出中残留的 Hugo 语法和常见的不安全残留物。

来源说明：本文内容整理自开源项目 agentic-awesome-skills（中文翻译版），遵循 CC BY 4.0（知识共享署名 4.0 国际）许可协议，此处作为中文资料整理分享，版权归原作者所有。

Hugo To Markdown 实用指南

Convert Hugo documentation sites and Hugo-managed content into standard Markdown. Use when Agent needs to inspect a local Hugo repository, read hugo.toml or config files, content/, archetypes/, layouts/_shortcodes/, layouts/_markup/, and related docs content, then produce Markdown...

开发工具

后端

Hugo转Markdown实用指南：提供从Hugo文档网站高效转换至标准Markdown的操作流程，涵盖配置解析、短代码处理、前置数据规范化及验证输出等关键步骤，确保语义完整且符合SEO优化要求。

路由

Redis

Agent

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Hugo To Markdown 实用指南

Hugo To Markdown 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐