Published as text

A page’s writing holds something Statac reads as words where you may have meant something else, so the page shows it as it is written. It is one of these:

• A call in doubled braces with an angle bracket or a percent sign, or a tag in a brace and a percent sign.
• A line holding nothing but a brace, a colon and what follows to the closing brace, which another tool reads as classes for the writing above it, or as a table of contents.
• Front matter with no --- lines: the file opens with a line naming one of Statac’s own words, such as title:, and every line up to the first blank one is a field or continues one.

{{< figure src="photo-1.jpg" >}}
{{% note %}}
{% include note.html %}
{: .box}
{:toc}

Writing is never read as a template, so none of these calls and marks reach Statac as anything but words. Front matter is read only between two --- lines at the very top of the file.

What you’ll see

warning  Published as text: `{{< figure src="photo-1.jpg" >}}` is another tool's call
  Call a snippet in its place, written `@name(...)`, or take it out.
  More: https://statac.dev/e/published-as-text/

In the terminal the message also names the file and line where there is one, and marks the exact text.

Why Statac warns

Statac publishes the page with what you wrote as it is, as it does any words, and tells you, because a reader would see it where you meant something else to be. Writing kept as code, in a code span, a code block or HTML’s own <pre> or comment, is left alone, and so is a brace written after a backslash.

How to fix it

Statac’s way to place a snippet in the writing is @name(...), with a snippet of that name in snippets/. Call one in place of the other tool’s call, or take the call out. For a mark, take it out, or write the HTML it stood for. To show the braces on purpose, put them in a code span. For front matter, put a --- line above the first field and another below the last.

Example

In content/post-1.md:

{{< figure src="photo-1.jpg" >}}

A note in a box.
{: .box}

With a snippet named figure in snippets/, call it, and write the box as HTML:

@figure(src="photo-1.jpg")

<div class="box">A note in a box.</div>

In content/post-2.md, the fields are published as the first paragraph:

title: Post 2
date: 2026-10-04

The first paragraph.

Put them between --- lines:

---
title: Post 2
date: 2026-10-04
---

The first paragraph.

Its name

Name	published-as-text
In the terminal	statac explain published-as-text
To stop showing it	quiet: [published-as-text] in statac.yaml, once you have understood it. Statac still counts it.