A brief introduction to all the blocks supported by MDX.one

Hello World 👋

This blog post is written in Notion and is a part of blog.mdx.one powered by MDX.one. Let's see what all you can do with MDX.one

Basic Blocks


You can write paragraphs like you normally would. The text you are reading currently is a paragraph. As you can see, all types of annotations are supported – bold, italic, underline, strikethrough, inline code, different text color, different text background or combinations of these.


All of the headings (H1, H2, H3) that are in Notion are supported by MDX.one
Here are the examples of how they look:
notion image

Todo Lists

You can also add todo lists like this:
Item 1
Item 2
Item 3

Bulleted List

You can also add lists as bullet points:
  • Item 1
  • Item 2
  • Item 3

Numbered List

Maybe you want them to be numbered. You can do that too.
  1. Item 1
  1. Item 2
  1. Item 3


You can even add a collapsible toggle and hide some content until the reader tries to reveal it. Click on the below toggle to see what's inside.
This is the summary
This is the content hidden inside a toggle.


You can even add quotes to your post which looks like this.
This is a quote.


You can even separate two blocks of content with a divider.


You can also make something standout by using a callout like this.
This is an interesting idea.



You can upload your own image and view that here.
notion image
You can also select one from Unsplash and display that.
notion image
If you a link to the image, you can use that to add images too.
notion image
You can even create some complex layouts of images, add captions to images and see them on your MDX.one blog.
MDX.one logo cover
MDX.one Open Graph Image
Unsplash image
Unsplash image


Want to show a youtube video on your blog post? You can do that. Most of the other popular video embeds should work too.


Easily add bookmarks to your blog post.


You can even directly embed audio files within your blog post and listen to them directly from your blog.
Don't bring an old problem's solution to a new tool that eliminates that problem. - Kent C. Dodds

Code Snippets

You can add your code snippets to your blog post. This might be very useful to you if you are writing technical blog posts.
const x = 2
let y = 1




You can also embed your tweets into your blog post. See the below example.

Google Drive

GitHub Gist



You can directly embed and interact with a figma design directly from your blog post.


There is still a lot more you can do with your MDX.one powered blog. If you have any feedback or want MDX.one to support an embed that isn't yet supported, reach out to me at tech@mdx.one.