Log in Sign up

Wikilinks

You can use wikilinks to create internal links between your posts. You can enable or disable wikilinks on the services page of your dashboard under Typography.

 Post.md 
This is a wikilink to a file called *Other post.md* in the same directory: 

[[Other post]]

The wikilink above is equivalent to this Markdown:

[Other post](/other-post)

  

You don’t need to know the URL of the linked post to create a wikilink, just the filename. Also, some note-taking applications, like Obsidian, create and update wikilinks automatically.

At the moment, Blot looks up the linked post in the following order:

  1. By file path When looking by file path, Blot first checks the contents of the wikilink as if it were a relative path, then an absolute path, and finally searches the directory containing your post by filename.
  2. By URL Works for posts and pages, is case-insensitive.
  3. By title Works for posts and pages, is case-insensitive.

Examples

Consider the following folder structure

 Your site
Name
Introduction.docx
Fruits
Apple.md
Pear.txt
Tasty
Mango.md
 

These are all valid Wikilinks for the files in the folder above:

Introduction.docx
[[Fruits/Apple]]
[[./Fruits/Pear]]
[[/Fruits/Tasty/Mango.md]]
Apple.md
[[Pear]]
[[./Tasty/Mango]]
[[/Introduction.docx]]
Mango.md
[[Fruits/Apple]]
[[../Apple]]
By default, the linked post's title will become the link's text. You can specify your own text using the following syntax:

[[Post.txt|Your link text here]]

Tip for Obsidian

For those who use Obsidian to manage their notes, I recommend setting the New link format to relative path to file. Blot will work with the New link format set to absolute path in vault as long as your Obsidian Vault is not inside a subdirectory of your site folder on Blot.

  1. Getting started
  2. Sync folder
  3. Files
  4. Metadata
  5. Sub-folders
  6. Formatting
  7. Set up site
  8. Reference