Here's a sentence with a footnote.[^1]
Task Lists
- [x] Completed task
- [ ] Incomplete task
Tables
| Header 1 | Header 2 |
|----------|----------|
| Cell 1 | Cell 2 |
Code Blocks
```python
def hello():
print("Hello, world!")
```
Syntax highlighting via Pygments (specify language after ```).
Math (LaTeX)
- Inline:
$E = mc^2$
- Block:
$$\int_0^\infty e^{-x^2} dx$$
Abbreviations
*[HTML]: Hypertext Markup Language
The HTML specification is maintained by the W3C.
Admonitions
.. note::
This is a note admonition.
.. warning::
This is a warning.
Table of Contents
.. toc::
Dynamic Variables
Use
{{ variable }}
in your content:
Blog Variables
{{ blog_title }}
— Blog title
{{ blog_description }}
— Blog meta description
{{ blog_created_date }}
— Blog creation date
{{ blog_last_modified }}
— Time since last modification
{{ blog_last_posted }}
— Time since last post
{{ blog_link }}
— Full blog URL
{{ tags }}
— Rendered tag list with links
Post Variables (in post templates)
{{ post_title }}
— Current post title
{{ post_description }}
— Post meta description
{{ post_published_date }}
— Publication date
{{ post_last_modified }}
— Time since modification
{{ post_link }}
— Full post URL
{{ next_post }}
— Link to next post
{{ previous_post }}
— Link to previous post
Post Listing
{{ posts }}
{{ posts limit:5 }}
{{ posts tag:"tech" }}
{{ posts tag:"tech,ai" limit:10 order:asc }}
{{ posts description:True image:True content:True }}
Parameters:
tag:
— filter by tag(s), comma-separated
limit:
— max number of posts
order:
— asc
or desc
(default: desc)
description:True
— show meta descriptions
image:True
— show meta images
content:True
— show full content (only on pages)
Email Signup (upgraded blogs only)
{{ email-signup }}
{{ email_signup }}
Links
Standard Links
[Link text](https://example.com)
[Link with title](https://example.com "Title text")
Open in New Tab
Prefix URL with
tab:
:
[External link](tab:https://example.com)
Heading Anchors
Headings automatically get slugified IDs:
## My Section Title
Links to:
#my-section-title
Typography
Automatic replacements:
(c)
→ ©
(C)
→ ©
(r)
→ ®
(R)
→ ®
(tm)
→ ™
(TM)
→ ™
(p)
→ ℗
(P)
→ ℗
+-
→ ±
Raw HTML
HTML is supported directly in Markdown:
<div class="custom-class" style="text-align: center;">
<p>Centered content with custom styling</p>
</div>
Note:
<script>
, <object>
, <embed>
, <form>
are stripped for free accounts. Iframes are whitelisted (YouTube, Vimeo, Spotify, etc.).
Whitelisted Iframe Sources
- youtube.com, youtube-nocookie.com
- vimeo.com
- soundcloud.com
- spotify.com
- codepen.io
- google.com (docs, drive, maps)
- bandcamp.com
- apple.com (music embeds)
- archive.org
- And more...
Dashboard URLs
Replace
<subdomain>
with your blog subdomain:
- Blog list:
https://bearblog.dev/dashboard/
- Dashboard:
https://bearblog.dev/<subdomain>/dashboard/
- Posts list:
https://bearblog.dev/<subdomain>/dashboard/posts/
- New post:
https://bearblog.dev/<subdomain>/dashboard/posts/new/
- Edit post:
https://bearblog.dev/<subdomain>/dashboard/posts/<uid>/
- Styles:
https://bearblog.dev/<subdomain>/dashboard/styles/
- Navigation:
https://bearblog.dev/<subdomain>/dashboard/nav/
- Analytics:
https://bearblog.dev/<subdomain>/dashboard/analytics/
- Settings:
https://bearblog.dev/<subdomain>/dashboard/settings/
Example: Complete Post
Header content:
title: Getting Started with AI Assistants
link: ai-assistants-intro
published_date: 2026-01-05 15:00
meta_description: A beginner's guide to working with AI assistants
tags: ai, tutorial, tech
is_page: false
lang: en
Body content:
AI assistants are changing how we work. Here's what you need to know.
Why AI Assistants?
They help with:
> "The best tool is the one you actually use." — Someone wise
Getting Started
Check out OpenAI or Anthropic for popular options.
What's your experience with AI? Let me know!
{{ previous_post }} {{ next_post }}
Tips
- Preview before publishing — Use the preview button to check formatting
- Use templates — Set up a post template in dashboard settings for consistent headers
- Schedule posts — Set
published_date
in the future
- Draft mode — Don't click publish to keep as draft
- Custom CSS — Add
class_name
and style in your blog's CSS
- SEO — Always set
meta_description
and meta_image
Troubleshooting
- Post not showing? Check
publish
status and published_date
- Tags not working? Use comma separation, no quotes
- Styling issues? Check
class_name
is slugified (lowercase, hyphens)
- Date format error? Use
YYYY-MM-DD HH:MM