Hugo + Obsidian: Simplified Post Management
On this page Table of Contents
How I Manage My Posting Workflow Using Obsidian
In this post, I’ll walk you through how I manage my posting workflow using Obsidian for editing and organising my posts. By utilising Obsidian’s features, I’ve made the entire process more efficient and streamlined.
-
Set Up the Template Folder in Hugo
First, I create a new subfolder called templates within my content folder. This folder will store all of my post templates, and I configure it to be ignored by Hugo. To do this, I update my hugo.toml configuration file by adding the following:
[module]
[[module.mounts]]
excludeFiles = 'templates/*'
source = 'content'
target = 'content'
This ensures that the contents of the templates folder are not processed by Hugo during site generation.
-
Create the Hugo Post Template
Next, I create a new note named hugo-post-template and paste the following YAML front matter:
---
title: {{title}}
date: {{date:YYYY-MM-DD}}T{{time:HH:mm:ss}}Z
draft: false
tags: []
categories: []
---
This template contains placeholders for the title, date, draft status, tags, and categories of the post. It will help me create posts quickly while maintaining consistency.
-
Open Hugo Content Folder as an Obsidian Vault
I have already set up my Hugo content folder as an Obsidian Vault. This allows me to view, edit, and manage all my posts within Obsidian, keeping everything in one place for easy access and organization.
-
Configure Obsidian Settings
In Obsidian’s settings, under Files and Links, I disable the option Use [[Wikilinks]]. This is because I prefer a more traditional markdown link structure. Additionally, I configure Obsidian to store my post images in the same location as the post itself, by updating the default attachment location.

-
Creating a New Post
To create a new post, I simply create a new note within Obsidian. Then, I press CTRL + P (or Command Palette) and search for Insert template. I select the hugo-post-template I created earlier. This automatically inserts the template with all the formatted fields ready for me to fill in.
-
Fill In the Post Fields
Now that I have a new post with the appropriate placeholders, I can simply go in and replace the fields like title, date, tags, and categories to personalise the post.
-
Enhance the Template Insertion Using the Commander Plugin
I use the Commander Plugin in Obsidian to add an “Insert Template” button to the left ribbon, making template insertion quicker without needing the command palette.

By following these steps, I’ve been able to streamline my workflow and make post creation in Obsidian as efficient as possible. With templates, configuration, and some simple automation, managing posts for my Hugo website has never been easier.
Comments