fbpx

A Guide To Markdown In Blot.im

by | Jun 11, 2019 | "How To" Tips

Home » "How To" Tips » A Guide To Markdown In Blot.im

I’ve been looking at ways to hack the SEO and Meta Data with Blot.Im. Blot.im is a platform I have started to use for my personal / adventure blog, Ijo Pona. I wanted to hack the meta data in all my posts so I can use Twitter Cards and Open Graph more effectively. Why would I want to do that? Well, I would get a two for one benefit right off the bat. I get better SEO and deletion of meta data duplicates that affect Google crawlers.

What Is Blot.im?

Blot is a blogging platform with no interface. Blot turns a folder into a blog. Drag-and-drop files inside to publish them. Organize your files in a way that suits you. Why a blogging platform with no interface? So you can blog with the tools you use already. Write your blog with your favorite text-editor. It is ace.

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.

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.

Dates

A blog post’s publish date is the same as the file’s creation date by default. You can specify a different date in the file’s path or in its metadata:

Post.txt
Date: MMMM Do, YYYY

Blot supports a variety of date formats. These all produce a post with the same date:

MM/DD/YYYY MMMM D, YYYY
M.D.YYYY YYYY-MM-DD 00:00

You can use underscores, dashes, slashes and dots to separate the numbers in the date.

You can specify a post’s publish date in its path. For example, all four of these posts share the same publish date:

YYYY› MM› DD› Post.txt
YYYY› MM› DD-[Post.txt]
YYYY› MM-DD-[Post.txt]
YYYY-MM-DD-00-00[-Post.txt]

Please note that a date specified inside a file overrules a date specified in its path. If you specify a date in the future, your post will be published then.

Tags

Use tags to connect posts by similar subject. Specify tags in the file’s metadata or in its path. Here’s an example blog post with two tags in its metadata:

Post.txt
Tags: Getting started, Documentation

Tags are case-insensitive and may contain whitespace. Blot picks the case you used last when displaying the tag on your blog.

You can add tags to a post in the file’s name or path. Include the tag, wrapped in brackets.

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.

 

Get in touch,

If you have a project in mind,
I would love to hear from you.

 

 

Pin It on Pinterest