This post is a living reference for writing on this site. Each section shows the rendered output followed by the syntax used to produce it. Bookmark this page.

Headings

H1 Heading

H2 Heading

H3 Heading

H4 Heading

Text Styling

Bold uses double asterisks.

Italic uses single asterisks.

Bold and italic uses triple asterisks.

Strikethrough uses double tildes.

Inline code uses backticks.

Text Color

Hugo markdown does not support inline color natively. Use HTML directly:

This text is grey.

This text is red.

<span style="color: #888;">This text is grey.</span>
<span style="color: #c0392b;">This text is red.</span>

Hyperlinks

Same tab link

New tab link

Link to another post on this site

[Same tab link](https://billweckel.com)
[Link to another post](/blog/my-first-post/)

For new tab, use HTML — markdown has no target attribute:

<a href="https://billweckel.com" target="_blank" rel="noopener">New tab link</a>

Single Image

Place the image in the same folder as your index.md then reference it:

![Alt text](filename.jpg)

With caption, use the figure shortcode:

Mini Gallery

Separate filenames with commas, no spaces. Images open in lightbox when clicked.

YouTube Embed

The VIDEO_ID is the part after ?v= in the YouTube URL.

Vimeo Embed

Pull Quote

The best camera is the one you have with you.

Button With Link

Code Block

function greet(name) {
  return 'Hello, ' + name;
}

def greet(name):
    return f"Hello, {name}"

Supported languages: javascript python html css bash json markdown toml

Ordered List

1. First item
2. Second item
3. Third item
   1. Nested item
   2. Another nested item

1. First item
2. Second item
   1. Nested item

Unordered List

• First item
• Second item
  • Nested item
  • Another nested item

- First item
- Second item
  - Nested item

Horizontal Rule

---

Blockquote

This is a blockquote. Use it for quotes from other people or sources.

> This is a blockquote.

SEO & Front Matter Reminder

Every post should have these fields:

---
title: "Your Post Title"
date: 2026-06-01
description: "One or two sentences. Under 160 characters. What is this post about?"
categories: ["Photography"]
tags: ["tag1", "tag2", "tag3"]
---

Description — appears in Google search results and social sharing previews. Keep it under 160 characters.

Categories — broad topics. Suggested: Photography, Scale Models, Art & Craft, Gear & Software. Use consistently.

Tags — specific subjects. Use lowercase, be consistent. wildlife not Wildlife.

To add a new category or tag just use it in a post — Hugo creates the archive page automatically. To rename one, use VS Code find and replace (Ctrl+Shift+H) across all post files.