Creating a Blog Post in Markdown

To create your blog post in Markdown format, you can use this example post as a template. You can view the rendered version of the same post on our website here.

You must modify the file’s header (or ‘front-matter’) as needed.

 ---
layout: distill
title: [Your Blog Title]
description: [Your blog post's abstract - no math/latex or hyperlinks!]
date: 2025-04-28
future: true
htmlwidgets: true

# anonymize when submitting 
authors:
  - name: Anonymous 

# do not fill this in until your post is accepted and you're publishing your camera-ready post!
# authors:
#   - name: Albert Einstein
#     url: "https://en.wikipedia.org/wiki/Albert_Einstein"
#     affiliations:
#       name: IAS, Princeton
#   - name: Boris Podolsky
#     url: "https://en.wikipedia.org/wiki/Boris_Podolsky"
#     affiliations:
#       name: IAS, Princeton
#   - name: Nathan Rosen
#     url: "https://en.wikipedia.org/wiki/Nathan_Rosen"
#     affiliations:
#       name: IAS, Princeton 

# must be the exact same name as your blogpost
bibliography: 2025-04-28-distill-example.bib  

# Add a table of contents to your post.
#   - make sure that TOC names match the actual section names
#     for hyperlinks within the post to work correctly.
toc:
  - name: [Section 1]
  - name: [Section 2]
  # you can additionally add subentries like so
    subsections:
    - name: [Subsection 2.1]
  - name: [Section 3]
---

# ... your blog post's content ...

You must change the title, discription, toc, and eventually the authors fields (ensure that the submission is anonymous for the review process).

Read our sample blog post carefully to see how you can add image assets, and how to write using \(\LaTeX\)!

Important: make sure your post is completely anonymized before you export and submit it!

Submission Instructions Summary

To create your post, you will:

Note: 2025-04-28-[SUBMISSION-NAME] acts as a unique tag for your submission. It should be consistent across all files.

For example, if you’re submitting a blog post titled Deep Learning, your tag would be:
2025-04-28-deep-learning

If you prefer to prepare your tutorial in a Jupyter Notebook, you are welcome to submit an overview of your tutorial in a Markdown (.md) file, along with the .ipynb notebook file, in a .zip folder. We will render the Markdown file and include a reference to your notebook on the blog page.

Upon submission, we will review and render accepted blog posts on our
Blogpost Track blog page.

Our template is based on the ICLR Blogposts 2025 project.
You can browse additional examples in their GitHub repository:
https://github.com/iclr-blogposts/2025/tree/main/_posts

Camera-ready

TBD - instructions will be provided closer to the submission deadline.

Full guide coming soon!