Markdown Cheat Sheet
Quick reference cheat sheet for Hugo markdown syntax — formatting, callouts, code blocks, math, diagrams, and shortcodes with examples.
Ownable uses GitHub Flavored Markdown (GFM) with powerful extensions for callouts, math, diagrams, and shortcodes. This page is a quick-reference cheat-sheet — click any topic for full documentation.
Quick Reference
| Syntax | Description | Guide |
|---|---|---|
**Bold**, *Italic* | Text formatting | Text Formatting |
[Link](url) | Internal & external links | Links |
- Item, 1. Item | Ordered, unordered, task lists | Lists & Task Lists |
 | Images, figures, captions | Images & Figures |
| Col | Col | | Markdown tables | Tables |
> [!NOTE] | Callouts / asides | Callouts |
```lang | Syntax-highlighted code | Code Blocks |
$E=mc^2$ | LaTeX math with KaTeX | Math (KaTeX) |
```mermaid | Flowcharts, sequence diagrams | Diagrams (Mermaid) |
Shortcodes
Shortcodes are special Hugo templates that insert rich components into your content.
| Shortcode | Description |
|---|---|
button | CTA buttons with styles, sizes, and icons |
icon | Inline SVG icons |
cards | Card grid layouts |
steps | Numbered step sequences |
spoiler | Collapsible/toggle content |
embed | GitHub, HuggingFace, and URL embeds |
video / audio | Media players |
notebook | Jupyter notebook rendering |
chart | Plotly interactive charts |
table | CSV table import |
cite / mention | Academic citations & author mentions |
toc / include | Table of contents & file includes |
Best Practices
- Relative Links — Use
[Link](../page)instead of full URLs for portability - Asset Location — Keep images in
assets/media/for global use, or in the page bundle for page-specific use - Accessibility — Always add alt text to images:
 - Prefer Markdown — Use standard Markdown (callouts, code blocks, tables) over shortcodes when possible for better portability
For front matter configuration (title, date, tags, images, etc.), see the Front Matter Reference. For page-level feature toggles (TOC, sharing, comments), see Page Features.
Was this page helpful?
Mobile Editing (iOS & Android)
Update your site on the go. Guide to Git-compatible mobile editors for iOS (Working Copy) and Android (GitJournal, Termux).
Create Content
Learn how to create pages, posts, publications, events, and more. Understand content types, file structure, and frontmatter configuration.
From the makers of
© 2026 Lore Labs.