# Add new blog post

1. Create new file at `/content/blog/yyyy-mm-dd-blog-post-title.md` and
   populate with the following metadata:

```toml
+++
title = "title of your blog post"
date = "yyyy-mm-dd"
description = "description of your blog post, will be displayed in blog listing"

[taxonomies]
tags = ['tags', 'docs', 'rant']

[extra]
# **Only use author nicks in blog post Markdown files, it is used to lookup author details.** 
author = 'imbatman' # author nickname
+++
```

2. Add author details in [`config.toml`](../config.toml) in `authors`
   under `extra` section:

   ```toml
   [extra]
	# Put all your custom variables here
	authors = [
		{ "nick"="imbatman", name="Batman", "website"="https://batman.example.org" },
		{ "nick"="superman", name="Superman", "website" ="https://superman.example.org" }
	]
	```

This information is used to render author information in blog posts.
**Only use author nicks in blog post Markdown files, it is used to
lookup author details.** 

3. Add content to your blog post file, save and commit! 🎉