Introduction
This is a sample blog post that demonstrates the structure and various markdown features you can use when writing blog posts for your Hugo site. Feel free to use this as a template or reference when creating your own content.
Text Formatting
You can use bold text for emphasis, italic text for subtle emphasis, and bold italic for strong emphasis. You can also use inline code for technical terms or code snippets.
Headings Structure
This is a Level 3 Heading
Your content can be organized using different heading levels. The post title is H1, so start your content sections with H2 (##) and use H3 (###) and beyond for subsections.
This is a Level 4 Heading
Even more specific subsections can use H4 headings.
Lists
Unordered Lists
Here’s an example of a bulleted list:
- First item
- Second item with more detail
- Third item
- Nested item 1
- Nested item 2
- Fourth item
Ordered Lists
And here’s a numbered list:
- First step
- Second step
- Third step
- Sub-step A
- Sub-step B
- Fourth step
Code Examples
Inline Code
When referencing commands or code inline, use backticks: npm install, docker build, kubectl get pods.
Code Blocks
For larger code snippets, use fenced code blocks with syntax highlighting:
# Example bash commands
cd /path/to/project
npm install
npm run build
# Example YAML configuration
apiVersion: v1
kind: Service
metadata:
name: my-service
spec:
selector:
app: my-app
ports:
- protocol: TCP
port: 80
targetPort: 9376
// Example JavaScript code
function greet(name) {
return `Hello, ${name}!`;
}
console.log(greet("World"));
Links and References
You can add links to external resources: Hugo Documentation
Or create reference-style links for cleaner markdown:
Check out the Kubernetes docs and Docker documentation for more information.
Blockquotes
Use blockquotes for highlighting important information or quotes:
This is a blockquote. It’s useful for highlighting important points, quotes from other sources, or key takeaways from your content.
Images
To add images, place them in the static/images/ directory and reference them like this:

Tables
You can also create tables (though they’re best used sparingly):
| Feature | Description | Status |
|---|---|---|
| Markdown | Full markdown support | ✓ |
| Code Blocks | Syntax highlighting | ✓ |
| Tags | Categorization | ✓ |
| Draft Mode | Hide unpublished posts | ✓ |
Horizontal Rules
Use three or more hyphens, asterisks, or underscores for horizontal rules:
Conclusion
This sample post demonstrates the key markdown features available for your blog posts. When creating your own posts:
- Create a new
.mdfile incontent/blog/ - Add frontmatter with title, date, excerpt, and tags
- Write your content using markdown
- Set
draft: falsewhen ready to publish - The Hugo server will automatically rebuild and show your new post
Feel free to modify or delete this sample post once you’re comfortable with the blog post structure!