Skip to content

Edit blocks with Markdown

New

Copy a block to your own AI assistant, reshape its content or turn it into a different block type, then paste the result back into the original block. You can also edit the Markdown directly in Slate.

  1. Open the block’s three-dot menu and choose View as Markdown.
  2. Click Copy and paste the block into your own AI assistant.
  3. Ask the assistant to revise the content or transform it into another supported block type.
  4. Copy the revised Markdown, return to the original block’s Markdown editor, and click Paste, or paste with your keyboard.
  5. Review the content and any notices, then click Save changes. You can also press Cmd+S or Ctrl+S while working in the Markdown editor.

Saving returns you to the visual block. To return without saving, choose View as block in the three-dot menu. If you have unsaved changes, Slate asks whether to keep editing or discard them.

The text represents one LESSON.md block, including its opening and closing ::: lines. Keep those lines when copying the Markdown between tools; you do not need to add a lesson title.

Copy a block into the AI assistant you already use and mention LESSON.md. An agent with web access can fetch the specification from lesson.md, so you do not need to supply the format reference. Ask it to shorten the wording, adapt the tone for your audience, or reorganize the content into another supported block type.

For example, copy a paragraph describing a procedure and ask:

Using the LESSON.md specification at lesson.md, convert this into one Process block with three steps. Use a vertical layout and minimal style. Give each step a short action title. Preserve the meaning and do not add new instructions. Return only the complete LESSON.md block, including its opening and closing ::: lines, without wrapping it in a code fence or adding an explanation.

Review the response for accuracy, then paste it into the original block’s Markdown editor. A replacement might look like this:

::: process
orientation: vertical
style: minimal
## Identify the issue
Ask what the person expected to happen and what happened instead.
## Check the basics
Check their connection and account access.
## Escalate with context
If the issue continues, record what you tried and escalate to the right team.
:::

Slate shows a notice when the replacement changes the block type. Click Save changes to turn the original block into a Process block in the same position.

Copying and editing Markdown uses no Slate AI credits and does not require a Slate MCP connection. Your external AI tool’s own access and usage limits apply.

Markdown replacement can transform content into another type supported by LESSON.md, such as Text to Process or Card to Accordion. Ask your agent to use the new type’s structure and properties from the specification at lesson.md. Changing only the block type name may not be enough to convert the content correctly.

For compatible types, such as Tabs and Accordion, the block menu’s Convert action offers a quicker route without editing Markdown.

The replacement keeps the block’s position and applicable visual styling. Its content is replaced, existing narration is cleared, and existing translations for that block are archived. Review the result, recreate any narration you need, and update translations to match the new source content.

Only properties represented by LESSON.md travel with copied Markdown. Use block templates or copy styles when you need to reuse visual settings. Media must still be accessible to the account saving the replacement; copying a reference does not grant access to another account’s files.

Copied Markdown preserves learner-name personalization, including the fallback text. Ask your AI assistant to preserve existing learner-name replacements when rewriting content.

If an edit adds, moves, or removes personalization, Slate requires you to select Allow personalization changes before saving. Review the replacement and its fallback wording before accepting. Invalid personalization must be corrected before the block can be saved.

Slate validates the replacement before enabling Save changes. Fix any inline error before saving:

  • One complete block - include the Markdown for exactly one supported block, with its opening and closing ::: lines. Multiple blocks and whole lessons cannot replace a single block.
  • Supported properties - resolve warnings about unsupported or invalid content; block replacement does not save input that produces parser warnings.
  • Size - keep the Markdown under 1 MB.
  • Assessments - only Text, Image, and Knowledge Check blocks are allowed. Assessment-wide scoring settings stay with the assessment.
  • Code blocks - Code has no LESSON.md representation to copy. With editing access, you can replace a Code block by pasting the Markdown for a supported block.

In read-only lessons, you can inspect and copy Markdown. When viewing a translation, the Markdown is the source-language block, not the translated text. Switch to the source language with editing access to replace it.

If clipboard access fails, select and copy the text manually or paste with your keyboard. Pasting only changes the editor; the lesson block changes when you save.

Use the lesson editor’s Copy as Markdown quick action to take an entire lesson to another tool. Bring a complete lesson back through LESSON.md import, rather than pasting it into one block. See Copy a lesson out as Markdown.