Shortcodes are small snippets you place in your Markdown content to render something the theme provides. Ananke ships the following shortcodes. Each entry lists what it does, its parameters, and an example.
form-contact #
Purpose: render a styled, accessible contact form.
Syntax:
{{< form-contact action="URL" >}}Parameters:
action(required) — the URL that receives the formPOST.
Output: an HTML form with name, email, and message fields and a Send button.
Example:
{{< form-contact action="https://formspree.io/your@email.com" >}}Common mistakes: omitting
action(the form then has nowhere to submit); expecting Netlify Forms to work without overriding the shortcode.
See the Contact Form page for full details, backends, and spam-protection notes.
page-index #
Purpose: render an index of child pages for a section. Used by the documentation’s own section pages to list their contents.
Syntax:
{{< page-index >}}Parameters: none.
Output: a list of the current section’s pages.
Example:
{{< page-index >}}Common mistakes: using it on a single page rather than a section (
_index.md) page, where there are no children to list.
since #
Purpose: render a small badge linking to the release where a feature was introduced (for example “since 2.17.0”).
Syntax:
{{< since "2.17.0" >}}or, reading the version from front matter,{{< since >}}.Parameters:
- version (optional) — passed as the first positional argument or as a named
versionargument. If omitted, the page’ssincefront matter value is used.
- version (optional) — passed as the first positional argument or as a named
Output: an anchor styled as a badge linking to the matching release tag.
Example:
{{< since "2.17.0" >}}Common mistakes: calling it with no argument on a page that has no
sincefront matter (a build-time warning is printed and nothing is rendered).
See the Since page for configuring the release URL and front-matter usage.
[!NOTE] This list reflects the shortcodes in the theme’s
layouts/_shortcodesdirectory. If you add your own shortcodes in your project’slayouts/_shortcodes, they are available too but are not documented here.
Since
Quick summary #
The since shortcode is used to render a small badge marking the release a
feature was introduced in (for example “since 2.17.0”). It is intended for
documentation and changelog-style pages. Use it when you need to mark, at a
glance, which version of a project a feature first shipped in. By default the
badge is plain text; configure a release URL to turn it into a link.
Contact Form
- What it outputs
- Required configuration
- Form fields
- A complete contact page
- Using a form backend
- Spam protection
- Customising labels
- Limitations
Ananke includes a form-contact shortcode that renders a ready-styled contact
form you can drop into any page.
What it outputs #
The shortcode outputs an accessible HTML <form> with name, email, and message
fields and a submit button, styled to match the theme. It submits with POST
to the address you give in the action parameter.