How to Use Obsidian Callouts and Wikilinks and Export Cleanly to Hugo (Markdown 101 - Part 09)

// SERIES: Markdown 101 (10 lessons · Jump to any part)
  1. 01 Capstone Practice - Write a Complete Markdown Article from Scratch (Markdown 101 - Part 10)
  2. 02 How to Add Links and SEO-Friendly Images in Markdown (Markdown 101 - Part 04)
  3. 03 How to Create Tables and Horizontal Rules in Markdown (Markdown 101 - Part 07)
  4. 04 How to Preview and Publish Markdown Posts to Hugo on GitHub Pages (Markdown 101 - Part 06)
  5. 05 How to Use Obsidian Callouts and Wikilinks and Export Cleanly to Hugo (Markdown 101 - Part 09)
  6. 06 How to Write Checklists, Footnotes, and Escaped Characters in Markdown (Markdown 101 - Part 08)
  7. 07 How to Write Headings, Paragraphs, and Emphasis in Markdown (Markdown 101 - Part 02)
  8. 08 How to Write Lists, Blockquotes, and Code Blocks in Markdown (Markdown 101 - Part 03)
  9. 09 Minimal Markdown Post Template and YAML Front Matter for Blogs (Markdown 101 - Part 05)
  10. 10 What Is Markdown and How to Create Your First .md File (Markdown 101 - Part 01)

Markdown 101 · Part 9/10

Obsidian extends standard Markdown with Callouts (> [!NOTE]), Wikilinks (Note Title), and highlights (==text==). When writing for a public Hugo blog, it helps to know which syntax converts automatically and which should stay standard Markdown.

Callout Boxes in Obsidian

Callouts build on standard > blockquotes with a bracketed type tag on the first line:

> [!NOTE] Quick Tip
> Answer the reader's core question in the opening two sentences.

> [!WARNING] Path Caution
> Never reference local drive paths in public blog posts.

Common built-in callout types include [!NOTE], [!TIP], [!IMPORTANT], [!WARNING], and [!CAUTION].

  • Wikilinks: link between personal notes using Note Title or Display Label.
  • Embedded images: prefix with !, such as !diagram.png.
  • Highlights: wrap text in double equals signs ==highlighted phrase==.

Publishing From Obsidian to Hugo

These extensions belong to Obsidian rather than core CommonMark:

  • In Dyn’s blog.py publisher, !image.png is automatically copied and converted into a Hugo image link, while Note brackets are stripped to plain text.
  • For public internal links between blog posts, always use standard Markdown links like [Part 1](/posts/markdown-101-01-getting-started/) so web browsers resolve the URL properly.
  • If your Hugo theme does not style Obsidian callouts or ==highlights==, stick to standard > blockquotes and **bold** text for consistent rendering everywhere.

Practice Now

Replace the Obsidian wikilink below with a standard Markdown link while keeping the blockquote intact.

Practice Now

Replace Part 01 with a standard Markdown link pointing to /en/posts/markdown-101-01-getting-started/.

Live Preview
Show hint

Use [Part 01](/posts/markdown-101-01-getting-started/) and keep the leading >.

Runs locally in your browser (nothing is uploaded or auto-saved). Supports headings, paragraphs, lists, checklists, tables, blockquotes, code, emphasis, links, and local site images.

Source: Obsidian Help: Callouts & Formatting.


In the Markdown 101 series:

Loading comments...