Blocks, prompts and documents

Write blocks, put them together into prompts, fill in variables, and copy the result.

This section is about writing and using your content: the blocks you write, the prompts you build from them, and the documents you keep as Markdown files. Use it when you want to create something new, change what you have, or copy a finished prompt into an AI tool.

The ideas to know first:

• Block: a reusable piece of prompt text with a name and a type, such as Role or Task. You write it once on the Blocks screen and use it in as many prompts as you like.
• Dynamic prompt: a prompt built from blocks on the Build screen. When you edit a block, every dynamic prompt that uses it changes too.
• Static prompt: fixed text. It doesn’t change when blocks do.
• Document: a Markdown file, such as a Skill for an AI tool, kept exactly as you write it.
• Variable: a named value, such as {{company name}}, that PromptMason fills in when you copy.

Start with Create and edit blocks, then Build a prompt. If you aren’t sure which kind of prompt to save, read Static prompts, dynamic prompts and documents. When a prompt is ready, see Copy and use a prompt for filling in values and copying it.

The other guides in this section cover variables, version history, comments, expected output and ready-made block packs.

Guides in this section

• Create and edit blocks: Write reusable pieces of prompt text, change them, copy them and see which prompts use them.
• Build a prompt: Put blocks together on the Build screen, check the result in the preview, and save it as a prompt.
• Static prompts, dynamic prompts and documents: Understand the three kinds of prompt, how each one behaves when a block changes, and how to write and edit each one.
• Library blocks and embedded blocks: Choose between a block you can reuse in any prompt and a block that belongs to one prompt only, and edit either from the Build screen.
• Copy and use a prompt: Find a saved prompt, fill in its values, copy it into your AI tool, and fix the warnings a prompt can show.
• Variables: Save a value once, such as your company name, and use it in any block or prompt, or have PromptMason ask for it each time you copy.
• 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.
• Markdown documents and Skills: Write, save, copy and download Markdown documents, such as Skills, on the Build screen.
• Edit a prompt as code: See a dynamic prompt's blocks written out as text, copy them, and edit them directly in the Code view.
• Add a block pack: Add a ready-made set of blocks, prompts and variables to your library, from the app or from a file downloaded from the website.
• Version history: See the earlier versions of a block, prompt or document, and restore one.
• Comments: Add, edit and delete comments about a block, prompt or document in the Comments panel.
• Expected output: Keep the results an AI tool gave for a block, prompt or document, with the tool and model that gave them.