Welcome to My Blog 🌱
About this site
This blog is written entirely in Obsidian-flavoured Markdown. Everything you see below is a demonstration of what Obsidian markdown can do — and how you can use it to make a blog that looks polished with almost no effort.
📌 Featured Posts
- How I Set Up My Homelab — notes from migrating to Proxmox VE
- Writing a Blog in Obsidian — why plain text beats a CMS
- My Favourite Command-Line Tools — a curated shortlist
Can’t decide? Start with the Welcome post.
✨ What Obsidian Markdown Can Do
1. Callouts
Callouts are the single biggest visual upgrade Obsidian gives you. They turn ordinary blockquotes into colour-coded panels:
A Note Callout
Perfect for asides, definitions, or “fun fact” boxes.
Tip
Use
> [!tip]for handy suggestions.
Success
> [!success]for completed goals and wins.
Warning
> [!warning]for gotchas and pitfalls.
Danger
> [!danger]for things that will ruin your day.
A Quote
“Simplicity is the ultimate sophistication.” — Leonardo da Vinci
Collapsible Callout
Add a
-to make any callout collapsed by default:> [!example]- Like this one. Click the header to expand. Great for long reference lists that shouldn’t dominate the page.
2. Wikilinks
Link posts without URLs or folders — just My Post Title. Obsidian keeps links alive even when you rename or move files:
- A link to another post: Homelab Migration Diary
- A link with custom text: the migration story
- A link to a heading inside a post: jump straight to lessons learned
3. Embeds
Embed a whole note or just a section of one directly into the page with ![[...]]:
Transclude of footer
You can also embed headings:
Transclude of style-guide#colours— perfect for reusing boilerplate, footers, or repeated disclaimers across posts.
4. Highlights
Wrap text in ==double equals== to get highlighted text — great for drawing the eye to key sentences without shouting in bold everywhere.
5. Tags
Tags give you free, automatic topic pages. Just sprinkle them anywhere in a post:
Popular tags on this blog: devops, obsidian, garden
6. Task Lists
Todo lists render as interactive checkboxes in published blogs:
- Write the index page
- Migrate notes into the blog vault
- Write about backups
- Publish an RSS feed
7. Tables
Plain Markdown tables, ready for comparisons:
| Tool | Purpose | Rating |
|---|---|---|
| Obsidian | Note-taking | ⭐⭐⭐⭐⭐ |
| Proxmox | Virtualisation | ⭐⭐⭐⭐⭐ |
| Netlify | Publishing | ⭐⭐⭐⭐ |
8. Code Blocks with Syntax Highlighting
# Publish the blog with one command
obsidian-blog build --vault ~/Blog --out ./dist
obsidian-blog deploy ./dist// Inline code + callouts + embeds = maintainable posts
export function formatDate(date: Date): string {
return date.toLocaleDateString("en-GB", {
day: "numeric",
month: "long",
year: "numeric",
});
}9. Footnotes
Add scholarly footnotes1 that your readers can hover or click2.
10. Math
Obsidian supports LaTeX via $...$ and $$...$$:
11. Diagrams with Mermaid
graph LR A[Write in Obsidian] --> B{Publish with<br/>blog plugin} B --> C[Static site] B --> D[RSS feed] C --> E[You, reading this]
12. Comments
Publishers ignore HTML comments, so you can leave notes-to-self inside posts:
🗂 Browse by Topic
| Topic | Posts |
|---|---|
| Homelab Migration Diary > Lessons Learned | 3 |
| Writing a Blog in Obsidian | 2 |
| My Favourite Command-Line Tools | 4 |
📮 Stay in Touch
Subscribe
New posts go out via RSS. Add this blog to your reader and you’ll never miss an update.
Thanks for reading — this site is a living document, grown one note at a time. 🌿