What is Timeattic and how to use it
Timeattic allow you to create a personal website from a set of notes written in a markdown format. You can create and edit your notes in any text editor, for example Obsidian.md.
You’re not limited in your choice of the markdown editor in any way, if Obsidian doesn’t work for you, you can choose something else.
You’ll also need a GitHub account, which you can create for free in one minute and a custom domain that you can get on GoDaddy or Namecheap. If you don’t yet have a Timeattic account you can create it at app.timeattic.com
For a getting started guide visit 5 Steps From Markdown Files to a Digital Garden
# Directory structure
Your vault must have a markdown file named
_indexin the root directory. The content of this file will be displayed on the front page of your website.
Timeattic uses filename based routing. This means that the URLs of your website will depend on the filenames that you choose. To avoid broken links and boost discoverability of your content, we suggest never updating a filename after posting.
If you do decide to update your filename, make sure to update all internal links to it. Obsidian has a very nice feature that automatically updates all references to a file when you update it’s name. Make sure it’s turned on in
Here’s an example of how filename based routing works.
Consider the following file structure in your vault.
If your custom domain name were
example.com, here’s the list of URLs you’d get after setting up your Timeattic website:
example.com- shows the content written in the root
example.com/articles- shows the content written in the nested file
example.com/notes- shows the list of all files in the
notesdirectory as there’s no
_index.mdfile in the
example.com/articles/How-to-write-well- will be built from from the file
/notes/How to write well.md. Notice that the URL doesn’t contain the
.mdfile extension and the spaces are replaced with hypens. The URL preserves the uppercase letters, so renaming a file to
/notes/how to write well.mdwould break the original URL. At the same time, explicitly using hypens instead of spaces in the filenames wouldn’t have any affect on the URL.
example.com/articles/Why-everyone-should-have-their-own-domain-name- derived from the last file in the
/articlesfolder following the same rules as before
example.com/notes/Digital-gardening- a web page from
example.com/notes/socially-acceptable- a web page from
favicon.png are optional. If you’re just getting started and don’t have a custom logo, you can skip them.
# Title and page metadata
All metadata should be included in the frontmatter. It’s a section in the beginning of your markdown file that’s wrapped in three dashes.
The two most common things that you’ll use would be
title (self explaining) and
lastmod (date of the most recent update).
# Private notes
The content in the
/private folder is excluded from the build and won’t be published. It’s a good place to store personal notes and drafts.
# Logo and favicon
To add a custom logo and favicon, you should place the files
favicon.png in the root directory of your vault.
To use Timeattic you’ll also need a GitHub account, which you can create for free in a few clicks. Once you have an account, you need to create a repository and push your markdown notes there.
writepermission to your GitHub repos to add a workflow action to your repo. This action is a script that builds a website from your markdown vault, which is later uploaded to AWS S3 and served via AWS CloudFront.
Timeattic tracks the branches
main for changes. These are the default branches and unless you try to do something clever, you won’t need to worry about anything here.
The repository can be private if you wish. This is especially useful if you’d like to use the
/private folder in your Vault to store private notes that won’t be posted on your website.
There are multiple ways to get your markdown notes into a GitHub repo. For Obsidian I suggest using a communit plugin called Obsidian Git.
# Custom domain name
Websites created via Timeattic are only available on custom domain names. You should own what you create and publishing your work on a custom domain is the best way build a recognizable brand from day one.
We’ll give you an SSL certificate immediately after you put it a domain name for your new website. You’ll need to verify the ownership of the domain by adding a CNAME record in the DNS settings.
Successful completion of this step enables secure communication with your website via HTTPS protocol.
Timeattic supports Obsidian callouts format (also known as admonitions).
Don’t post anything illegal!
Some callouts can be folded by default.
# Link format
Extenal links should be prefixed with the protocol, like
https://example.com. If you just put in
example.com it won’t work.
Internal links should be written in the common markdown standard,
[click here](notes/socially-acceptable). Wikilinks like
[[socially-acceptable]] aren’t supported.
If you’re using Obsidian go to
Settings > Files and Links and alter the default settings:
- set the new link format to
Absolute path in vault
- disable the toggle
By default you’re limited to 100 MB per website (tens of millions of words). It’s plenty if you’re writing in markdown and use occasional images. If you’d like to have that limit increased, please contact us at email@example.com and describe your usecase.
The key thing is that you shouldn’t treat Timeattic as a media hosting platform. We’re giving a way for our users to create websites from a set of markdown notes and current limitations exist to prevent abuse.