MARKUPDOWN SPECIFICATION

MUD-SPEC v0.1

Team DC · FutureVision Labs · ::: render fences · ++ executable blocks · extension .mud

Every component below shows .mud source beside its HTML output — the same pipeline Code Designer uses on export.

Mud Pies Tutorial 🥧 MUD64 (C64 screens) 🕹️ Full demo .mud Markdown source

1. Design principles

  1. Plain text first — diff-friendly, Git-native, CeeDee-trainable.
  2. Two block families — presentation (:::) vs execution (++). Never mix semantics.
  3. Component-aware — blocks map to HTML regions, CURSY classes, and export targets.
  4. Deployed realities only — examples reference live .live properties where possible.

2. Core markdown

ConstructSyntax
Title# H1
Section## H2 … ###### H6
Bold / emphasis**bold** · *em*
Link[label](url)
List- item or 1. item
Blockquote> quote

3. Block families

.mud — render fence 
::: hero
title: Mud Pies
subtitle: Bake your first .mud file
:::
.mud — executable 
++ N.O.N. hub config
hub
    name "FutureVision Live"
    port 3000

4. Document frontmatter

.mud source 
---
title: SexBox.Live Launch Canon
description: Hardware manifest and network ring
og_image: assets/markupdown-hero.png
export:
  html: dist/canon.html
  pdf: print/canon.pdf
theme: cursy-dark
toc: true
---
HTML output (head)
<title>SexBox.Live Launch Canon</title> <meta name="description" content="…"> <meta property="og:image" content="…"> <link rel="stylesheet" href="cursy-dark.css"> <!-- toc: true → inserts ::: toc after hero -->

5. Render components (:::)

5.1

hero

Page opener — eyebrow, title, subtitle, image, CTA row.

.mud source 
::: hero
eyebrow: MARKUPDOWN TUTORIAL
title: Mud Pies
subtitle: Bake your first .mud file
cta:
  - [Learn More](about.html#mud)
  - [Join Waitlist](waitlist.html) primary
:::
HTML output

MARKUPDOWN TUTORIAL

Mud Pies

Bake your first .mud file

Learn More Join Waitlist
5.2 · 5.3

grid + card

Flexbox grid container with nested card tiles.

.mud source 
::: grid columns=3 gap=1.5rem responsive
::: card
icon: 🌐
title: futurevision.live
body: Sovereign multimedia hub
:::
::: card
icon: 📖
title: flipzine.live
body: Digital throne — magazine sync
:::
::: card
icon: 🎮
title: homebrewz.live
body: EmulatorJS arcade
:::
:::
HTML output
🌐
futurevision.live
Sovereign multimedia hub
📖
flipzine.live
Digital throne — magazine sync
🎮
homebrewz.live
EmulatorJS arcade
5.5

embed

Sandboxed iframe or sanitized HTML island.

.mud source 
::: embed sandbox
src: https://homebrewz.live/play.html
height: 480
title: EmulatorJS Playground
:::
HTML output
▶ iframe sandbox homebrewz.live/play.html
5.6 · 5.18

form / waitlist

Declarative forms — preset waitlist wires to Code Designer API.

.mud source 
::: form contact action=/api/waitlist.php
field name text label="Your name" required
field email email label="Email" required
field message textarea rows=4
submit: Join Waitlist
:::
HTML output
5.7

callout

Admonitions — note tip warning canon danger

.mud source 
::: callout canon
**Deployed realities only.**
Do not document vaporware in canon .mud files.
:::

::: callout warning
**Unverified build.** QA pending SoftRadix review.
:::
HTML output
Deployed realities only. Do not document vaporware in canon .mud files.
Unverified build. QA pending SoftRadix review.
5.8

cta

.mud source 
::: cta
title: Ready to get muddy?
body: Join the Code Designer waitlist.
button: [Join Waitlist](waitlist.html) primary
:::
HTML output

Ready to get muddy?

Join the Code Designer waitlist.

Join Waitlist
5.9

media

.mud source 
::: media
src: assets/markupdown-hero.png
alt: MarkUpDown workflow
caption: Author once. Export everywhere.
:::
HTML output
MarkUpDown workflow
Author once. Export everywhere.
5.13

marquee

.mud source 
::: marquee speed=slow
SEXBOX.LIVE · HOMEBREWZ.LIVE · FLIPZINE.LIVE · FUTUREVISION.LIVE
:::
HTML output
SEXBOX.LIVE · HOMEBREWZ.LIVE · FLIPZINE.LIVE · FUTUREVISION.LIVE · SEXBOX.LIVE · HOMEBREWZ.LIVE ·
5.14

table spec

.mud source 
::: table spec
| Row | Physical | Digital | Shield |
|-----|----------|---------|--------|
| SexBox | RPi 5 | Portal | SoftRadix QA |
| FlipZine | — | flipzine.live | Magazine sync |
:::
HTML output
RowPhysicalDigitalShield
SexBoxRPi 5PortalSoftRadix QA
FlipZine—flipzine.liveMagazine sync
5.12

tabs / accordion

.mud source 
::: tabs
tab: Hardware
- Raspberry Pi 5
- Chromium kiosk
tab: Network
- futurevision.live
- flipzine.live
:::

::: accordion
item: What is .mud?
MarkUpDown — documentation notation.
item: What is N.O.N.?
NEXT Object Notation — n-o-n.space
:::
HTML output
  • Raspberry Pi 5
  • Chromium kiosk
  • futurevision.live
  • flipzine.live
What is .mud?

MarkUpDown — documentation notation.

What is N.O.N.?

NEXT Object Notation — n-o-n.space

5.19 · 5.20

gallery / flip

.mud source 
::: gallery columns=2
- assets/markupdown-hero.png | MarkUpDown
- assets/code-designer-icon.png | Code Designer
:::

::: flip
left: |
  # Cover story
  Inspired Cafe pilot
right: |
  ## Cast
  - Dr. D · Gemzy
:::
HTML output
MarkUpDown Code Designer
Cover story

Inspired Cafe pilot

Cast

Dr. D · Gemzy

6. Executable blocks (++)

.mud source 
++ export manifest
html "dist/page.html"
pdf  "print/page.pdf"
code "src/generated/"

++ N.O.N. hub config
hub
    name "FutureVision Live"
    port 3000

::: non
hub
    name "FutureVision Live"
    port 3000
:::
Export output
📄 dist/page.html
📄 print/page.pdf
📁 src/generated/

📄 hub.non
hub
  name "FutureVision Live"
  port 3000

8. Export pipeline

  1. Parse frontmatter
  2. Build AST (markdown + ::: nodes + ++ nodes)
  3. Resolve include / {{include}}
  4. Render HTML (CURSY default theme)
  5. Optional PDF via print stylesheet
  6. Emit ++ blocks to paths in export manifest

MUD64 is a separate companion spec for Commodore 64 flip-screen adventures, PETSCII, and silicon export — not part of MUD-SPEC v0.1. See MUD64-SPEC and the CRT player.

10. Version history

VersionDateNotes
0.12026-05-23Initial spec — ::: fences, hero/grid/toc/embed/form, extended components; HTML page with output examples
Mud Pies Tutorial → MUD64 (C64) → Download demo .mud