How to Start a Blog With Typora

Typora is a great place to write a blog: clean, fast, and every post is a Markdown file you own. This guide sets up a blog written in Typora and published with Sentilis Press, with a routine you can keep for years.

Set up the blog folder

Create a folder and open it in Typora with File → Open Folder:

my-blog/
└── press/
    ├── why-i-write-in-plain-text.md
    └── lisbon-in-three-days/
        ├── lisbon-in-three-days.md
        └── attachments/
            └── cover.jpg

Before your first image, set Preferences → Image to copy inserted images to ./attachments, globally. See publishing Typora Markdown as a website for details.

Write a post

Start each post with a settings block — type --- on the first line and Typora opens it:

---
name: Why I write in plain text
category: Essays
tags: writing, tools
status: draft
---

Every post on this blog is a Markdown file on my laptop…

• name is the title shown on the page.
• category groups posts and appears as a label.
• tags are lowercase keywords; use hyphens for multi-word tags, like note-taking. Each tag links to a filtered list of posts.
• status starts as draft.

Drafts, published, archived

Keep status: draft while you write — drafts are not visible to readers, even after you sync. Switch to published when the post is ready. Use archived to take an old post down without deleting the file.

Covers and images

Drop a cover.jpg (or .png, .jpeg, .webp) into the post’s attachments/ folder and it becomes the image shown when the post is shared. Other images you paste in Typora go to the same folder. The text in quotes after an image becomes its caption:

![Tram 28](./attachments/tram.jpg "Tram 28, Alfama")

Keep all the media of one post under 5 MB.

Publish

npm i -g @sentilis/cli
sentilis auth login <your-token>
sentilis sync ./my-blog

A routine that lasts

1. Write in Typora with status: draft.
2. Read it once in Typora’s rendered view — it’s close to what readers see.
3. Change the status to published and run sentilis sync ./my-blog.
4. To fix a typo later, edit and sync again: the post keeps its URL.

Because every post is a plain file, your archive is also a backup: copy the folder, put it in Git, or sync it — it stays readable in any editor.

Publish your Typora blog →