Featured image of post Hugo Markdown Guide

Hugo Markdown Guide

Blowfish Markdown Syntax Guide

Heading (H2)

Subheading (H3)

Regular text. Bold, Italic, Strikethrough


Images

Method 1: Local Image

Place image file in the post folder:

![Image description](image.jpg)

Method 2: External Image URL

![Image description](https://example.com/image.jpg)

Method 3: HTML Tag (with size control)

<img src="image.jpg" alt="Image description" width="500" />

16:9


21:9

Code Blocks

Inline Code

Use inline code format

Code Blocks

package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}
def hello():
    print("Hello, World!")
docker run -d -p 8080:80 nginx

Link text

Link text

Article Reference

/docs/welcome/Open linked article

Lists

Unordered List

  • Item 1
  • Item 2
    • Sub-item 2-1
    • Sub-item 2-2
  • Item 3

Ordered List

  1. First
  2. Second
  3. Third

Checklist

  • Todo 1
  • Completed
  • Todo 2

Blockquote

This is a blockquote. Multiple lines are supported.


Table

ItemDescriptionNote
ADescription ANote A
BDescription BNote B

YouTube Video

{{< youtube VIDEO_ID >}}

Twitter/X

{{< twitter user=“username” id=“tweet_id” >}}

GitHub Gist

{{< gist username gist_id >}}


Alert Boxes (Blowfish Alert)

{{< alert “circle-info” >}} Information alert. {{< /alert >}}

{{< alert “lightbulb” >}} Tips and ideas. {{< /alert >}}

{{< alert “triangle-exclamation” >}} Warning message. {{< /alert >}}


Collapsible (Details)

Click to expand

Hidden content appears here.


Comments


Horizontal Rule

Use to create dividing lines:


Footnotes

You can add footnotes1 to text.


Chart


Mermaid Diagram


Swatches (color showcase)

#64748b
#3b82f6
#06b6d4

TypeIt

(Ex1)

<p id="stack-typeit-6" class="stack-typeit stack-typeit-cursor"></p>

(Ex2)

<h1 id="stack-typeit-7" class="stack-typeit stack-typeit-cursor"></h1>

(Ex3)

<h3 id="stack-typeit-8" class="stack-typeit stack-typeit-cursor"></h3>

Youtube Lite


Writing Tips:

  • Change draft: true to false in front matter to publish
  • Writing description and summary helps with SEO
  • It’s recommended to place images in the post folder

  1. This is the footnote content. ↩︎