Welcome to the blog. This post lives in a page bundle: a folder named hello-world/ containing index.md plus any images for this post.

Adding images

Option 1 — image lives next to the post (recommended). Drop the file into this post’s folder and reference it by filename:

A placeholder image

Option 2 — shared/global image. Put it in static/images/ and reference it with an absolute path:

Logo

Writing a new post

hugo new content posts/my-next-post/index.md
# edit the file, set draft = false, drop images in the same folder
git add . && git commit -m "new post" && git push

That’s the whole workflow. On push, GitHub Actions builds the site and deploys it to https://blog.nckslvr.mn.

Markdown works as you’d expect

  • Lists
  • Bold, italic, inline code
  • Links

Blockquotes look like this.