Publishing with Blot

Blot creates a folder in your Dropbox and publishes files you put inside. These files become blog posts automatically:

You can organize your folder however you like. There are three folders which Blot treats differently:


Blot automatically generates a publish date, permalink, thumbnail and a list of tags for each blog post. However, you can specify this metadata yourself:

Date: February 28th, 1973
Permalink: gravity

# Gravity's Rainbow

A screaming comes across the sky.

Metadata must start on the first line and be separated from the rest of the post with a blank line.

You can specify custom metadata and access it in your blog's template.

You can create a page elsewhere in your blog's folder by adding Page: yes to the file's metadata. If you'd like to create a page that isn't on your blog's menu, add Menu: no as well.


You can specify an entry's publish date in the metadata at the top of a file. Blot supports plenty of formats. The following dates are equivalent:

23/06/2012    23.6.12    23-6-2012    2012-6-23 00:00

You can use the file's path to specify an entry's date. The entries for the following files have a publish date of midnight on February 23rd, 2016:

/2016/2/23/post.txt    /2016/   2016_02_23_00:00_post.txt

If you order your dates differently please tell Blot on the settings page. If you change an entry's date to some time in future, Blot will wait until then to publish it.

You can specify an entry's permalink in the metadata at the top of a file. For example, to create a blog post with the permalink, add this:

Permalink: raspberry

Permalinks can contain slashes and accents. If you're migrating to Blot from a different platform, consider setting up redirects instead.


You can specify tags in the metadata at the top of a file:

Tags: Literature, Book reviews

You can also use folders to tag posts. For example, files in a folder called [Literature] will become blog posts tagged 'Literature'. You can nest tag folders:

[Literature] / [Book reviews] / Lamiel.txt


Blot attempts to generate a thumbnail for each blog post. By default, Blot will use the largest JPEG or PNG image in your blog post. You can override this and specify a path or URL to an image in the metadata at the top of a file. If you use a path, make sure the image is inside Blot's folder.

If your blog post has no image, then your blog post will not have a thumbnail. Learn how to use these thumbnails in your template.