Choose a page to begin.

Blocks

Blocks appear when a piece of content needs to be read as one complete surface. In the Developer Portal, that usually means the structure of what you are looking at matters, not just a single word inside it.

Code Blocks

When a code block appears, the portal is showing a real snippet with line order, indentation, and relationships between lines kept intact. That is different from print or repeatCount inside a sentence, where only the exact name needs emphasis.

code-snippet.luau
1local message = "Hello world"2local repeatCount = 33 4for index = 1, repeatCount do5  print(message, index)6end
A full code block usually means the exact structure is part of the message.

Markdown Blocks

The same full-width treatment can also be used for formatted writing. When a markdown block appears, it usually means the headings, lists, and small bits of structure inside the writing are worth preserving as one contained explanation.

Blocks are not limited to source code.

Markdown Blocks

  • A markdown block is used when the content needs headings, lists, and inline code in one surface.
  • This gives longer explanations a clearer structure without breaking them into several loose paragraphs.

Example

This format keeps structure visible, preserves the raw markdown for copying, and matches the same presentation rhythm as code blocks.

Image Variant

A markdown block can also be attached to an image instead of sitting on its own. In that variant, the image fades into the same content surface below it so the visual and the writing read as one connected piece.

nullX monochrome wave banner

Image Variant

  • This keeps the image and markdown inside one connected surface.
  • The banner fades down into the same body area the text uses.
  • It works well when the visual is part of the explanation instead of a separate card.

This is the same blended variant used on the Board when a post includes a banner image.

What Blocks Usually Mean

On a page, a block usually means "read this as one unit." It is where the portal tends to show a complete example, a copyable snippet, or a self-contained piece of formatted writing that would lose clarity if it were flattened into normal body text.