Formatting, block headers and hidden notes

Format the text of blocks and prompts, control the header lines between blocks, and leave notes that never reach the AI.

This page covers the text editor you use for blocks and static prompts, the header lines PromptMason can put above each block in a prompt, and hidden notes: text you keep in a block or prompt that’s left out whenever it’s copied.

The text editor

You write in the same editor on the Blocks screen, in the Prompts screen’s static prompts, and on the Build screen in embedded blocks and the Edit block window. It works like a word processor: what you see is how the text is formatted. The toolbar above it has:

When AI assist is set up, its button is at the right end of the toolbar (Improve text with AI assist). To put in a variable, type {{ and pick a name from the list.

What isn’t supported

The editor has no headings, quotes, code blocks, strikethrough, underline or links. For a document that needs them, such as a Skill, write a Markdown document instead.

A line that starts with # stays exactly as you type it. It isn’t turned into a heading, so you can write your own section markers, such as ### CONTEXT ###.

What the formatting does when you copy

When you copy a prompt, PromptMason puts two versions on the clipboard, and the app you paste into picks one:

• Apps that take formatted text, such as Word, Google Docs and Slack, get the bold, italics, colors and lists.
• Apps that only take plain text, including many AI chat boxes, get the words without bold, italics or colors. Lists keep their - and 1. markers.

Bold, italics and color don’t reach an app that takes plain text, so don’t rely on them to tell an AI model something. Say it in words, or use a block header.

Block headers

In a dynamic prompt, each block can have a header line above its text, so an AI model can tell the parts apart. On the Build screen, each block has two boxes:

• Include Type writes the block’s type in capitals.
• Include Name writes the block’s name.

Each block in each prompt keeps its own choice. See Build a prompt.

Choose whether new blocks start with headers

1. Click Settings in the sidebar, then Blocks & prompts.
2. Under When you add a block to a prompt, turn on Include the block’s name, Include the block’s type, or both.

Blocks you add to a prompt from then on start with those boxes ticked. Blocks already in a prompt keep their own choice.

Change the header marker

The marker is the ### written on both sides of a header.

1. Click Settings in the sidebar, then Blocks & prompts.
2. Under Block headers, type a new marker in the Block header marker box, for example *** or ===.
3. Press Enter or click outside the box. The marker can be up to 10 characters.

The Example line under the box shows what a header will look like. To go back to ###, click Reset.

If the marker can’t be used, a message under the box says why, and the old marker stays in use:

Change the space between blocks

1. Click Settings in the sidebar, then Blocks & prompts.
2. Under Between blocks, set Blank lines between blocks to 1, 2 or 3. The default is 1.

The blank lines go only before a block that has a header (Include Type or Include Name ticked). A block with no header continues the section above it, with no blank line between them. This keeps several short blocks, such as a list of rules, together under one header. The first block in a prompt has nothing above it, so no blank line goes before it.

PromptMason also tidies blank lines inside a block’s text when it puts a prompt together: blank lines at the start and end are dropped, and a run of two or more in the middle counts as one. The block itself isn’t changed.

The marker and the spacing apply to every dynamic prompt, in the preview and in the text you copy. A static prompt keeps the headers and spacing it was saved with.

Hidden notes

A hidden note is text in a block or prompt that’s left out whenever the text is previewed or copied. Use it for reminders to yourself, such as why a line is there or what to change next time.

Write a note between {{! and }}:

Summarize the report in plain language. {{! Legal asked for no jargon. }}

When you copy this, you get only “Summarize the report in plain language.”

How notes work:

• A note can go anywhere in the text, and can run over several lines.
• If a note is alone on its line, the whole line is left out, so no blank line is left behind.
• The note ends at the first }}. Don’t put }} inside a note.
• If you forget the closing }}, nothing is hidden: the {{! shows as typed.
• A note is never read as a variable.
• Each block’s notes are removed on their own, so a note in one block can’t hide the next block.
• A static prompt saved from Build keeps its notes, still hidden when you copy it.

Hidden notes are saved with the text. Anyone who can open the block or prompt can read them, and AI assist sends the text with its notes, so don’t use them for anything private.

Hidden notes are different from Comments, which are kept in a separate panel under the list (or under the canvas on Build) and are never part of the text. Markdown documents don’t hide notes: a document is kept and copied exactly as written.