Obsidian Markdown Guide

Using Markdown in Obsidian is a bit different from the default usual Markdown that you may be used to. Obsidian supports a variety of extra syntactical features to Markdown that make creating content even easier.

In the guide, we will go over the nuances and new features that Obsidian brings to our Markdown experience. We will begin our journey with callouts.

Callouts

These are similar to Markdown quotes that you may have been used to, but with an added syntax to the first line of a quote allows us to format the “quote”, in many different ways.

Starting off with the most basic info callout.

> [!info]
> 
> Here is some special info!

Which looks like this rendered with Obsidian.

Info

Here is some special info!

Moving on we have the tip callout.

> [!tip]
> 
> Here's a great tip.

And again rendered with Obsidian.

Tip

Here’s a great tip.

Notice how we always change the keyword within the first line of the quote to change the styling. That’s how all of them work. Here’s showcase of the 12 supported callouts (excluding Info & Tip as they are above).

Showcase

Note

This is a note. Use the note keyword in the first line of the quote.

Summary

This is a summary. You can also use the aliases tldr & abstract

Todo

This is a todo item.

Tip

This is a tip. You may also use the aliases hint & important

Success

Aliases: succcess, check, done

Question

Aliases: question, help, faq

Warning

Aliases: warning, attention, caution

Failure

Aliases: failure, missing, fail

Danger

Aliases: danger, error

Bug

This is a bug

Example

This is an example

Quote

Aliases: quote & cite

Nested Callouts

Yes! We can nest our callouts! Even multiple nesting is supported!!

Can we nest our callouts?

Yes we can!!

We can even do multiple layers like this!