simplex

Blogs · 2026-08-13 · 2 min

How this journal works

Drop a .md file in the blog folder. Headings, tables, tasks, callouts, math, video, and Mermaid render on their own.

Simplex Digital · studio · writing

Write in Markdown. Save the file in blog/. Refresh. That is the whole publishing process.

Frontmatter at the top is optional. If you skip it, the first heading becomes the title and the first paragraph becomes the excerpt.

yaml
---
title: Optional title
description: Optional excerpt
date: 2026-08-13
author: Your name
tags: [ads, web]
cover: /images/studio-desk.jpg
draft: false
---

Set draft: true to hide a note in production. Files that start with _ are ignored, so _template.md is a starter, not a post.

Text

You can write bold, italic, struck, inline code, and highlighted text. Links look like this.

A quote is just a greater-than sign, the way it is in Notion.

Lists, tasks, tables

  • Nested
    • lists
    • work as expected
  • Numbered lists do too
  1. Discover
  2. Design
  3. Build
  • Audit the site
  • Turn the ads on
  • Read Monday's number
FormatWorks
TablesYes
CheckboxesYes
DividersYes

Callouts

GitHub / Notion style:

Directive style, if you prefer:

Open for the short version

The journal is a folder of Markdown files. There is no CMS.

Code

js
const inquiry = calls + forms + bookings

Math

Inline: the cost per inquiry is C=S/IC = S / I.

Block:

ROAS=revenuead spend\text{ROAS} = \frac{\text{revenue}}{\text{ad spend}}

Mermaid

Video

Paste a YouTube or Vimeo URL on its own line:

Images

Use a public path, a full URL, or a file sitting next to the Markdown:

md
![Desk](/images/studio-desk.jpg "The studio table")
![Local file](./photo.jpg)

Local files in blog/ are served automatically.

That is all

Add blog/any-name.md. It becomes /blog/any-name. Folders work: blog/guides/pixel.md is /blog/guides/pixel.