1. Docs
2. Getting started

Your first post

A Markdown file in content/posts/, and it’s on the home page.

Create it#

hugo new content posts/hello-world.md

This writes content/posts/hello-world.md with a title and today’s date filled in:

---
title: "Hello World"
date: 2026-10-19T09:00:00+02:00
draft: true
summary: ""
---

Write it#

Below the second ---, write in Markdown:

A first paragraph. **Bold**, *italic*, and a [link](https://gohugo.io/).

## A heading

- a list
- with two items

Fill in summary: one sentence for the post’s card on the home page and in the Posts section. Without one, Fieldnotes takes the beginning of the text.

Markdown shows every element and how Fieldnotes draws it.

See it#

A post with draft: true is only shown by hugo server -D (-D for drafts):

hugo server -D

When it’s ready, set draft: false or delete the line. The post then appears on the home page and under Posts, newest first.

Photos in a post#

Make the post a folder, a page bundle, so its photos sit next to it:

content/posts/hello-world/
├── index.md       the post (the old hello-world.md, renamed)
└── view.jpg

![The valley from the pass, with clouds below](view.jpg "The view on day two")

The text in square brackets is the alt text, read out to people who can’t see the photo: always write it. The text in quotes becomes the caption. Fieldnotes makes smaller copies for phones by itself. Next: publish.