{l ,)]_)Q x/[:i1 x};^_\] |l'l1 ,Aq. $(>""?)] x)[1|x ,c> !"""i{_ ,t~,,!}{ 1{[t }"^^i[l :xfi;,`l{c l)+,~| j1<,^^~{] !l[l;:"`<f#/ CQ/l$ )>::i$ $\?,^""<1]IC!%!l;"^![)\()))(-I""";! 1;""",+/#<+I!~i^^",:;:::::,^^"";{ t[+^,"";+]\?;l!>;,,"::""""""`^,:-{} x}l"""":][!,,,:,,"<r|l;""",u::,,!I )!"""^"~)>,,,,,:;J%Bul""}d8al""I] (I;"""^;?>,,,,,:I(W8(;"";LM8P"`+] {)+""""^]>,,,,,,;I:",,"",;nI("*[r t_:",,"<i,"",,,,,,""^""",,"^`![ ])_",;;:I:"""""""""""""""^^^^^+r /?I;;;;;;;:""^^^^""^^^^"""^^^:-x Q(}<lI;;;:::""^^^"````'"^^^""`:;f #j)+lII;;:::::"^^"''`'`''`'"^^^^;]t ](1~;;;;;;;::::^^"'``'''`''`'"^^^^~)$ )?>I;^,:::::::^^"'``''`''`''``'"^^"?# ░▄▓▓▓▓▓▓▒▄▄░ ▒▓▓▓▓▓▒ ▒▓▓▓▓▓░[>I;,^▒▓▓▓▓:::^^'``'░▄▒▓▓▓▓▓▒▄░`"░▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒ ▒▓▓▓▓░ ░▄▒▓▓▓▓▓▄▄░ ▒▓▓▓▓▓░ ▒▓▓▓ ▒████████████▓ ░███████░ ▒██████░ x▓████``^^''░▓████████████▓`▒█████████████████▓ ▓████░ ░▓█████████████▄ ▓██████░ █████ ░████▓░░ ░░░▀▒▒ ░█████████░ ▒███████▒ /▓████```^'▒█████▓░░`'░░▀▓▒'░░░░░░░█████░░░░░░░ ▓████░ ▒█████▒░░ ░▀▓█████░ ▓███████░ █████ ▒████▒ ▓████░████▓ ▒████▓███▒ t|▓████````▒█████░''`'''`''`''''^;"'█████░( ▓████░ ░█████░ ▒████▓ ▓████▓███░ █████ ███▓▓▒▄░ ▒████░ ░████▒ ▒████░▓███▒ ▓████ )█████░``;+_i;"^^''`''`''`█████░"!^'''''▓████░ ▓████▒ █████░ ▓████░▓███░ █████ ▀▓██████████▓░ ░████▒ ▒████░ ▒████░ ▒███▒:▓████:[){█████░'''.`''"^^qxi])})];█████░'-1x ▓████░ ▓████▒ ▓████▒ ▓████ ▓███▒ █████ ░▒▀▒▒█████ ▒██▒▒▒▒░░▒████▒ ▒█▒▒▒░ ▒▒██▒▓█▒██{{ █▒▒█▒▒``''^;;:qf/wx [}█▒▒▒▒▒''-\# ▒█▒██▒ ▒▒███▓ ███▒█▒ ▓▒█▒█ ▒▒█▒▒█▒██▒ ░ █████ ▓███████████████▓ ▒████░ ▒████████ ░█████░'`'^]()1' ]█████░'':-)r ▓████░ ░█████░ ▓████▓ ▓████ ▒████████ ░██▓▒▄▄▄▄▄▓████▓ ▒████▓▀▀▀▀▀▀▀▓████▒ ▒████░`'``▒███████]\!"`░██████▒▄▄▄▄▄▓█▓ l{<`'█████░}) ▓████░ ░█████▓▄▄▄▄▒█████▓ ▓████ ▒███████ ░█████████████▒ ░████▓ ▓████░ ▒████░ ]{;▒██████ }▀▓███████████▒ █████░``'",>(|▓████░ ▀▓███████████▓░ ▓████ ▒██████ ░░▀▀▀▀▀▀░░ ░░░░░░ ░░░░░ ░░░░░ x(!''░░░░░░ {};^░░▀▀▀▀▀░░ ░░░░░};"''`,i-░░░░░ ░░▀▀▀▀▀░░ ░░░░░ ░░░░░░ )i`''''!? |};"'''```l{ {)1i.'''`^"l[} #1>^''.^;{ |+:`''`??'`,} kt'``''.^"?{) t?<>]}x l)l^'''``;>~})] x)]<<!:^:i} \1_iii>+?})\x `\\|\1})* \||\)tt $# #x x/

updates/mdcat-showcase.md markdown · 353 words

mdcat and its syntax

posted 2026-09-16updated 2026-10-182 min readthe birth of mdcat, and a tour of everything it can render

.
├── Overview
└── Markdown syntax
    ├── Text
    ├── Headings
    ├── Lists
    ├── Code
    └── Blocks

        ／l、      MEOW!
       （ﾟ､ ｡ ７  /
         l、ﾞ~ヽ
         じしf_,)ノ

# Overview

So I guess I've decided on a name for my zola theme. It's going to be called mdcat, and I think the reasoning behind the name should be pretty self-explanatory, haha.

Anyway, I'd say I'm around 80% finished with the syntax. I should also mention that building this website is actually a small part of a larger project which I'm working on. I hope to share more about it in the future, but for now I hope that you enjoy my showcase below:

# Markdown syntax

## Text

Emphasis leans, strong text stands out, inline code borders, and struck text ~~fades~~. Where markdown has no syntax, HTML fills in: highlighted text, keys like Ctrl+C, H₂O and 2¹⁰.

A footnote sits at the end of a sentence^[1], and a line that ends in a backslash
breaks without starting a new paragraph. Links stay inside the site, like the updates directory.

## Headings

Headings keep their marks, and the marks are the anchor links. This one has a custom anchor, #custom, set in the source.

## Lists

a bullet
- nested one level
another bullet

first
second

done: struck and dimmed
still to do

[raw]: a definition list: term above, definition below
[sig]: the detached signature, on a page that has one

## Code

1#!/bin/sh
2# check a page before trusting it
3gpg --verify updates/mail-server.txt || exit 1
4echo "signature good"

The frame shows the file name and language; linenos numbers the lines and hl_lines marks one. Without a language it is only a frame:

$ mdcat updates/mdcat-showcase.md

## Blocks

A quote holds code, emphasis and paragraphs.

Quotes nest.

An alert is a quote with a tag. TIP, IMPORTANT, WARNING and CAUTION work the same way.

Folded callout

This one starts closed. Only the [+] opens it.

element	source	rendered as
heading	`## Title`	white, marks kept
callout	`note` component	labelled frame
alert	`> [!NOTE]`	quote, tag kept

Footnotes gather here, dimmed, with a link back to where they came from. ↩

[..] [raw] [sig] [top]