Components & Aliases

Micropage markup has a small set of components, with a few aliases for flexibility and readability. This page lists the canonical syntax and all supported aliases.

Use the canonical forms in new markup, but all aliases shown here are supported and not deprecated.

Structure & headings

Purpose	Canonical	Aliases	Notes
Section	/// section	/// hero, /// container, /// html	Section type is the first line after ///.
Heading 1	h1:	h:	h: is an explicit alias for h1:.
Heading 2–6	h2:–h6:	–	Standard heading levels.
Paragraph	p:	bare text	If no prefix is present, a line is treated as a paragraph.

Media

Element	Canonical	Aliases	Notes
Image	img:	image:	Used with <- for keyword, filename, or URL.
Icon	icon:	–	Uses name <- url syntax.

Image references

Use <- with img: or image::

• Keyword (Unsplash search): img: <- coffee
• Filename (project file): img: <- hero.png
• Direct URL: img: <- https://example.com/screenshot.png

Site logo and favicon inside [site] can use shorthands:

• logo: logo.png (equivalent to img: <- logo.png)
• favicon: favicon.png (equivalent to img: <- favicon.png)

Image links

You can combine image lookup and a click-through URL:

img: Hero <- hero.png -> /pricing

This resolves the image using <- hero.png and treats /pricing as the link target for that image.

Navigation & links

Element	Canonical	Aliases	Notes
Page link	Text -> /path	link: Text -> /path, a: Text -> /path	All forms produce a link element.

Forms

Form fields are nested under a form: block.

form: Contact

input: Name*
textarea: Message
submit: Send

Form container

Purpose	Canonical	Aliases	Notes
Form	form:	–	Starts a form; fields that follow are nested inside.

Field elements

Field type	Canonical	Aliases	Notes
Text input	input:	textfield:	Single-line text.
Text area	textarea:	text:	Multi-line text.
Select	select:	–	select: Label [one, two]
Checkboxes	checkboxes:	multichoice:, multi-choice:	Multiple choice; all aliases are fully supported.
Radios	radios:	choice:, singlechoice:, single-choice:	Single choice; all aliases are fully supported.
Submit	submit:	save:	Both create a submit button.

Fields ending in * are required in all forms and aliases.

Buttons

Buttons are links with variants (sizes/styles) controlled by the prefix.

button: Get Started -> /signup
btn-secondary: Learn more -> /features

Button prefixes and variants

Prefix	Variant	Typical use
button:	primary	Main call to action.
btn:	primary	Shorthand for primary buttons.
btn-secondary:	secondary	Secondary actions.
btn-info:	info	Informational actions.
btn-warning:	warning	Destructive or cautionary actions.
btn-danger:	danger	Strongly destructive actions.

All prefixes above are supported and first-class; choose the variant that best matches the importance of the action.

HTML & small text

Element	Canonical	Aliases	Notes
Raw HTML section	/// html	–	Section type html returns raw HTML.
Inline HTML	html:	–	Inline HTML element inside a section.
Small text	small:	–	Small-print or helper text.