Get GAXPRO
Content

Blog Articles: content/blog/*.md

How to add blog articles in GAX Pro. Covers frontmatter fields, body content, tags, canonical URLs, and how articles appear in the blog listing.

Blog Articles: content/blog/*.md

Where Blog Articles Live

Blog articles are Markdown files inside:


content/blog/

Each file becomes a page at /blog/[filename]/. For example:

  • content/blog/what-is-gax.md → /blog/what-is-gax/
  • content/blog/gax-vs-hugo.md → /blog/gax-vs-hugo/

The filename becomes the URL slug. Use lowercase words separated by hyphens for SEO-friendly URLs.

Blog Article Frontmatter

Every blog article has the same frontmatter structure:


---
layout: post
title: "What Is GAX? The Go Static Site Generator Explained"
description: "GAX is a Go static site generator with pre-built themes, YAML config, and auto collections."
label: "Introduction"
image: "/images/go-ssg4.webp"
date: 2026-09-11
toc: true
author: "GAX Pro Team"
tags:
  - golang
  - ssg
  - go-static-site-generator
canonical: "https://gaxpro.axcora.com/blog/what-is-gax/"
keywords: "what is gax, go static site generator"
---
  • layout: post — uses the blog article layout
  • title — shown as the article heading and in search results
  • description — used for SEO and social sharing
  • label — a short category label above the title
  • image — hero image at the top of the article
  • date — publication date in YYYY-MM-DD format
  • toc — enable table of contents (true or false)
  • author — author name
  • tags — list of tags, used for tag pages
  • canonical — the canonical URL
  • keywords — additional SEO keywords

Writing the Article Body

Below the frontmatter, the body is standard Markdown:


# What Is GAX?

GAX is a Go static site generator that compiles Markdown content
and templates into static HTML.

## How It Works

GAX reads Markdown files, applies templates, and outputs a `site/` folder.

### Content Folder

All content lives in `content/`.

## Next Steps

- **[Read the docs](/docs/)**
- **[Try the free engine](https://gax.axcora.com)**

The body supports headings, lists, links, images, code blocks, tables, and blockquotes.

Heading Structure

The article layout renders the title as the H1 heading. This means the body should start with H2 headings, not H1:


## First Section

Content here.

### Subsection

Content here.

## Second Section

Content here.

Using H1 in the body creates a duplicate heading. The page has two H1s, which is a minor SEO issue.

How Articles Appear in the Listing

The blog listing at /blog/ shows articles from content/blog/. Each article appears as a card with:

  • The image from frontmatter
  • The title
  • The description
  • The date
  • The label if present

Articles are sorted by date, newest first. The listing shows 5 articles per page (configured in content/blog.md).

Tags

Tags are defined in frontmatter:


tags:
  - golang
  - ssg
  - go-static-site-generator

Each tag creates a tag page at /tags/[tag]/. For example, golang creates /tags/golang/.

Use lowercase tags with hyphens for multi-word tags:


tags:
  - static-site
  - seo

Tags appear in the tag list at /tags/ and in the article page as clickable links.

Table of Contents

The toc: true field enables a table of contents at the top of the article. The TOC is generated from the H2 and H3 headings in the body.

For the TOC to work:

1. Set toc: true in frontmatter

2. Use H2 and H3 headings in the body

3. Keep headings short and descriptive

If toc: false or the field is missing, no table of contents appears.

Adding a New Article

To add a blog article:

1. Create a new Markdown file in content/blog/

2. Use a descriptive filename with hyphens — my-new-article.md

3. Add frontmatter with layout: post, title, description, date, and tags

4. Write the body in Markdown

5. Save the file and rebuild

Example minimal article:


---
layout: post
title: "My New Article"
description: "A short description of the article."
image: "/images/go-ssg4.webp"
date: 2026-10-01
toc: true
author: "GAX Pro Team"
tags:
  - go-static-site-generator
canonical: "https://gaxpro.axcora.com/blog/my-new-article/"
---

## Introduction

Content here.

## Section

More content here.

Removing an Article

To remove an article, delete its Markdown file from content/blog/. The listing and tag pages update automatically on the next build.

Common Errors

Article shows 404 — the file is not in content/blog/, or the filename is misspelled.

Article does not appear in the listing — the frontmatter is missing layout: post, or the collection in content/blog.md does not match the folder name.

Tags do not appear — the tags field is missing or not formatted as a YAML list.

TOC does not appear — toc: true is missing, or the body has no H2 or H3 headings.

Build fails — YAML syntax error in frontmatter. Check indentation and quotes.

Next Step

Blog articles are set. Next, add service articles:

Need Help?

  • Contact us — if an article does not render correctly