Formatting Template
This is the reference template for authoring Workshop Studio Hands-On Labs. Every page demonstrates a documented content directive or formatting option: it shows the rendered example first, followed by a fenced code block with the exact source you can copy and paste into your own lab.
Use it two ways:
- Browse the pages below to see what each directive looks like when rendered.
- Copy the source blocks straight into your content and adjust the values.
Everything here is based on the official Workshop Studio directive documentation. Nothing is invented. If a formatting option is not shown on these pages, it is not a supported directive.
| Section | Directive(s) | Declaration types | What it does |
|---|---|---|---|
| Directive syntax | (general) | text / leaf / container | The three directive forms and how to nest them |
| Alerts | :alert | leaf, container | Callouts: info, success, warning, error |
| Code blocks | :code | text, leaf, container | Copyable, syntax-highlighted code and terminal output |
| Expand | :expand | leaf, container | Collapsible sections (reveal / hide content) |
| Tabs | :tabs / :tab | container | Switch between alternative views |
| Images | :image | text | Images with width, height, zoom and link options |
| Links & buttons | :link, :button | text | Hyperlinks and action buttons, including downloads |
| Video | :video | leaf | Embed a YouTube or Vimeo video |
| Params & asset URLs | :param, :assetUrl | text | Reusable contentspec values and signed asset URLs |
| Children | :children | leaf | Auto-generated list of child pages |
| Tables & Markdown | (CommonMark) | - | Standard Markdown supported by Workshop Studio |
| Page anatomy | (structure) | - | Front matter, file naming and folder ordering |
The same list, generated automatically from the child pages: