Content helpers

This section covers the small but important pieces that keep content predictable as it scales.

Together, these rules define how content moves through the system without adding friction or hidden behavior.

Drafts

Any page with draft: true in front matter is dropped on build and kept on serve. The preprocessor is on automatically; you don't register it. Use it for in-progress pages you want to preview locally without shipping.

---
title: 'Half-written thoughts'
draft: true
---

Don't reach for custom environment variables for things these two already cover. If you find yourself reading process.env.SOMETHING_CUSTOM to decide whether to render a page, check first whether one of the two above is the real signal.

---

Wikilinks

Forward links, MediaWiki-style. All resolved at render time, all combinable:

• [[slug]] links to the page with that slug. The link text defaults to the page's title.
• [[slug#anchor]] links to a heading on that page. The anchor is slugified for you.
• [[slug:lang]] hops to the translation in the named language (BCP47 code, e.g. [[about:fr]]).
• [[slug|alias]] sets custom link text. The pipe is the alias separator.

The forms compose. [[about:fr#team|notre equipe]] is valid. Misses (unknown slug, missing translation) render as the original literal text rather than a broken link, so a typo is visible without crashing the build.

Slugs are global within the default language. Backlinks are intentionally not generated. Curated cross-references win over automatic ones.

Where they work. Wikilinks are a markdown-it inline rule, so they resolve in .md body content only. They do not run in Nunjucks templates or in front matter values. If you need a link from a layout or a data field, write the URL directly.

---

Images

The shortcode is Baseline's. The heavier transform isn't.

• {% image %} is always registered. eleventy-img is a peer dep that ships with Baseline.
• AVIF and WebP by default. No JPEG fallback. Modern browsers handle these and the file size difference is real.
• The HTML transform that rewrites <img> into responsive <picture> (eleventyImageTransformPlugin) is opt-in. You add it yourself if you want it. When it is present, the shortcode marks its own output with eleventy:ignore to avoid double-processing.

Alt text matters. The shortcode warns when it is missing (use an empty string for decorative images). The image-transform how-to walks through the responsive pipeline.

---