Metadata

Each post’s permalink, title and publish date is generated automatically. You can override some or all of this metadata on the file’s first line. Metadata must be separated from the rest of the post by at least one blank line.

 Post.txt 
Date: MMMM Do, YYYY
Permalink: /metadata

You must leave a space after the colon between the metadata property (e.g. Date) and its value. Metadata must be separated from the rest of the post by at least one blank line. 


Metadata reference

Title Defaults to the text of the first heading in the blog post or the file’s name.
Date Defaults to the file’s creation date. Specify a different date in the file’s metadata with one of the supported formats. You can also change a post’s publish date using the file’s path.
Permalink Defaults to a URL-friendly version of the post’s title. Specify a different permalink in the file’s metadata, or adjust the default permalink format.
Summary Defaults to the text of the first sentence of the first paragraph in the file.
Teaser Defaults to the first few paragraphs of the blog post. You can specify a teaser in the file’s metadata or insert the breakpoint {{more}} yourself.You can specify the end of the teaser using the {{more}} tag somewhere in the file.

Everything above the {{more}} tag, including this line, will be in the post’s teaser.
Tags You can tag a blog post in the file’s metadata or using the file’s path.
Thumbnail Defaults to the largest image in the blog post. You can specify a URL, or a path to an image in your blog’s folder.
Draft Determines whether a file becomes a draft. Can be Yes’ or No’. Defaults to No’ unless the file is inside a folder called Drafts’.
Page Determines whether a file becomes a page or a blog post. Can be Yes’ or No’. Defaults to No’ unless the file is inside a folder called Pages’.
Menu Determines whether a file appears on your blog’s menu. Can be Yes’ or No’. Defaults to Yes’ for pages and No’ for blog posts.

Custom metadata

You can also define your own metadata for use in your template. Blot uses

Metadata in HTML files

You can use a comment at the start of an HTML file to specify metadata.

1
2
3
4
5
6
7
8
9
10
<!--
Date: MMMM Do, YYYY
Permalink: /metadata
-->

The comment containing metadata in an HTML file
<b>must</b> start on the file's first line.