Markdown To

SpecificationsnormativeSheet 06 of 18

countdown@0.1

One absolute moment, a clear completion message, and supporting prose. The HTML becomes a live, accessible timer; the Markdown stays timeless, portable state.

File
*.countdown.md
Target
RFC 3339 with offset
Verb
status · read-only
Codes
MDTO600–699
Read agent skill · authoring and editorial guide

§ 01

The file, and the ticking view

The source is inert and deterministic. The projection updates once per declared precision, pauses while hidden, catches up on return, and announces completion exactly once.

Fig. 1An authored launch moment becomes a luminous timerself-contained
launch.countdown.md
---
markdownto: [email protected]
title: Artemis launch window
target: 2027-02-03T18:30:00Z
precision: seconds
completion-message: The window is open.
---

# Artemis launch window

The clock is shared by the launch team, guests, and everyone watching from home.

## Before zero

- Join the broadcast ten minutes early.
- Keep the mission brief nearby.

## At zero

The timer changes state once and keeps the event notes on screen.
rendered · live timerfixed script · no network
Counting toward

Artemis launch window

00days
00hours
00minutes
00seconds

Live countdown

The clock is shared by the launch team, guests, and everyone watching from home.

Before zero

  • Join the broadcast ten minutes early.
  • Keep the mission brief nearby.

At zero

The timer changes state once and keeps the event notes on screen.

§ 02

Grammar with no relative-time ambiguity

target:
A real RFC 3339 instant with explicit Z or numeric offset. “Three days” is never canonical state.
precision:
seconds or minutes; seconds is the default.
##
Optional supporting sections: ordinary safe GFM, not timer state.

§ 03

Verb reference

Verb

Meaning

Source edit

status

Reports target, sampled instant, state, milliseconds, and decomposed units. --at makes it deterministic.

None. The timer source is read-only.

§ 04

Failures point at the authored fact

broken.countdown.md
---
markdownto: [email protected]
target: 2027-02-30T09:00:00
---

This is neither a real date nor an offset-qualified instant.

mdto validate

  • MDTO601 error line 3

    target: 2027-02-30T09:00:00

    target must be a real RFC 3339 date-time with an explicit Z or numeric offset.

The complete agent-facing document is available as countdown.md, and mdto spec countdown prints the same contract locally.