Paulblish supports a bunch of standard html page content, as well as a few extra nifty little things that sets it apart. Please remember: this is hyper-personalised software, so I have included the things I want to have in a website.

If you want to modify or extend Paulblish then fork it and add your own, or contribute back, I would love free new features on my website so thanks!

Text formatting

Heading 1

Heading 2

Heading 3

Heading 4

Normal text, duh

  • bullet
  • points
  1. Numbered
  2. lists

Links to other sites

Wiki links to other markdown files

Here is a foot note [1]

Those <hr> things, see! ☝ 👇

More complex markdown things

Code blocks

file.py
1
print("python code blocks")

Mermaid.js diagrams

flowchart TD
    Start(Use hyper-personal software) --> Stop(Enjoy writing software again!)

Tables

Platform Table support
Others Results may vary
Paulblish Supported ⭐

Callouts

Call-outs!

Call-out blocks work too

Foldable call-outs too?

Yes, they work!

Images

Image, duh

(check the alt text to see it works too)

Frontmatter supported properties

Home.md

yaml
cname: creates a CNAME file with this content, for github pages support
avatar: relative path to an image will show an icon on the home page
description: used in the <meta name="description"> tag
title: used in the <title> tag
bluesky: link to a bluesky account will create a social icon
github: link to a github account will create a github icon
email: link to an email will create a mailto: link

Articles

yaml
author: Your name
created: date (also determines the next/prev link order!)
permalink: local path (uses directories to build paths, btw)
tags: builds static tag pages grouping related articles
publish: bool, determines if the article is generated or not

Other features

  • An RSS feed is automatically generated for you.
  • As is a robots.txt and the relevant site map.
  • And also a 404 page which perhaps can be funnier...
  • Did you click on any of the tags at the top of the page yet? That's all just static pages too.
  • Various open graph and twitter tags are also generated (inspect the source of this page and look in the <head> and you'll see what I mean).

I missed something!

Let me know, and I'll consider it if it's something I want - just drop an issue on the project

  1. Hello! Footnotes work! ↩︎