// This skill should be used when writing or editing blog posts, creating new content pages, using Hugo shortcodes (codapi, youtube, vimeo), writing callouts/alerts, adding code blocks, working with front matter, or authoring any Markdown content for the Hugo site. Also use when working with render hooks, taxonomy, or content organization.
| name | hugo-content |
| description | This skill should be used when writing or editing blog posts, creating new content pages, using Hugo shortcodes (codapi, youtube, vimeo), writing callouts/alerts, adding code blocks, working with front matter, or authoring any Markdown content for the Hugo site. Also use when working with render hooks, taxonomy, or content organization. |
Use when writing, editing, or reviewing blog post content and Markdown files.
Posts go in content/blog/ as YYYY-MM-DD-slug.md. The date prefix keeps
files sorted; the slug becomes the URL path.
---
title: "Post Title"
date: YYYY-MM-DD
tags: ["tag1", "tag2"]
categories: ["category"]
---
Optional: draft: true to hide from production builds (visible with make serve).
Use fenced code blocks with language identifier. Use golang not go to
avoid GDScript misdetection.
Full list of language identifiers: Hugo Syntax Highlighting Languages
Implementation: layouts/_default/_markup/render-codeblock.html (adds copy button).
GitHub-style blockquote alerts:
> [!NOTE]
> Informational note.
> [!TIP]
> Helpful advice.
> [!WARNING]
> Potential issue.
> [!IMPORTANT]
> Critical information.
> [!CAUTION]
> Dangerous action warning.
> [!EXAMPLE]
> Example content.
> [!QUOTE]
> Attributed quotation.
> [!INFO]
> General information (alias for NOTE).
Implementation: layouts/_default/_markup/render-blockquote.html.
Run code in-browser via WebAssembly. Scripts load only when shortcode is used.
{{</* codapi sandbox="python" */>}}
print("Hello, World!")
{{</* /codapi */>}}
Supported sandboxes: javascript, fetch, python, ruby, lua, php, sqlite.
Implementation: layouts/shortcodes/codapi.html.
{{</* youtube VIDEO_ID */>}}
{{</* vimeo VIDEO_ID */>}}
Standard Goldmark syntax:
Text with a footnote[^1].
[^1]: Footnote content.
GitHub URLs auto-format with icons via render hook:
github.com/user renders as @usergithub.com/owner/repo renders as owner/repoImplementation: layouts/_default/_markup/render-link.html.
content/blog/YYYY-MM-DD-slug.mdcontent/about.mdtags and categories (defined in hugo.toml)/blog/:year/:month/:day/:slug/content/blog/hello-hugo.md (draft: true) showcases all theme features.
Use as reference for syntax. Never published.
make serve # Dev server with drafts
make build # Production build
make linkcheck # Check for broken internal links