Blog Posts

Create date-ordered blog posts with categories, tags, authors, and featured images. Perfect for research updates, news, and tutorials.

Blog posts are date-ordered entries for research updates, news, tutorials, and announcements. They support categories, tags, authors, featured images, and automatic reading time.

Quick Start

Open the Ownable sidebar in VS Code.
Click + (Create) next to Posts.
Enter a title and press Enter.

Install Ownable CMS for visual content management.

hugo new content/blog/my-new-post.md

Navigate to content/blog/.
Create a new .md file or folder with index.md.
Add the frontmatter template below.

File Structure

_index.md # Blog listing page

hello-world.md # Simple blog post (leaf page)

index.md # Page bundle (post + assets)

featured.jpg # Featured image

data.csv # Bundled asset

Leaf Pages vs. Page Bundles

Leaf page: A single .md file — quick and simple.
Page bundle: A folder with index.md + assets. Use when you need a featured image or attached files.

Frontmatter Template

---
title: "My First Blog Post"
date: 2024-03-15
lastmod: 2024-03-20

# Authors (reference data/authors/*.yaml)
authors:
  - jane-doe

# Taxonomy
categories:
  - Research
tags:
  - machine-learning
  - deep-learning

# Featured image (if using page bundle)
image:
  filename: featured.jpg
  caption: "Image credit: Unsplash"
  focal_point: Smart

# Summary (for cards and SEO)
summary: "A brief overview of our latest research findings."

# Reading time (auto-calculated, but overridable)
reading_time: true

# Pin to top of listings
featured: false

# Draft mode
draft: false
---

Your blog post content in Markdown.

Featured Images

Place featured.jpg (or .png) in the post's folder:

index.md

featured.jpg

The image is automatically detected — no frontmatter needed!

Reference an image from the assets/media/ folder:

image:
  filename: my-image.jpg   # Located in assets/media/
  caption: "Photo credit: Unsplash"
  focal_point: Smart       # Smart, Center, Top, Left, Right, Bottom
  preview_only: false      # true = only show on listing, not on page

Categories & Tags

Use categories for broad groupings and tags for specific topics:

categories:
  - Research
  - Tutorial
tags:
  - python
  - machine-learning
  - data-visualization

Categories and tags automatically generate listing pages at /categories/ and /tags/.

Pinning Posts

Pin a post to the top of listings:

featured: true

Featured posts appear first, regardless of date.

Quick Reference

Field	Type	Description
`title`	`string`	Post title (required)
`date`	`date`	Publication date
`lastmod`	`date`	Last modified date
`authors`	`list`	Author slugs from `data/authors/`
`categories`	`list`	Broad content categories
`tags`	`list`	Specific topic tags
`summary`	`string`	Short summary for cards and SEO
`image.filename`	`string`	Featured image filename
`featured`	`bool`	Pin to top of listings
`draft`	`bool`	Hide from published site
`reading_time`	`bool`	Show estimated reading time