Documentation Index
Fetch the complete documentation index at: https://mintlify.com/retypeapp/retype/llms.txt
Use this file to discover all available pages before exploring further.
Retype extends standard Markdown image syntax and adds dedicated components for embedding videos and iframes.
Images
The standard Markdown image syntax is used to embed images. Images can reference files within the project or external URLs.
Caption
The text between [] is used as an optional caption displayed below the image.
title attribute can be added after the URL, in quotes. Most browsers display this as a tooltip on hover.
Linked images
Wrap the image in a standard Markdown link to make it clickable.
[](https://retype.com)
[](/guides/getting-started.md)
Dimensions
Control image size using the pipe | separator after the alt text.
 <!-- width and height -->
 <!-- width only (height scales proportionally) -->
Custom HTML attributes
Append a {...} block after the image to set any HTML attribute.
{#custom-id}
{.rounded-lg}
{width="300" height="200"}
{.rounded-lg width="300"}
{data-location="Korea"}
{.rounded-lg width="300" data-location="Korea"}
Alignment
When an image is placed on its own line, Retype provides alignment options using - prefix/suffix characters.
| Position | Markdown | Description |
|---|
center (default) |  | Center aligned |
left | - | Float left |
leftplus | -- | Float left with negative left offset |
right | - | Float right |
rightplus | -- | Float right with negative right offset |
centerplus | ---- | Center with negative offset both sides |
Alignment options only apply to images placed on their own line. Inline images (on the same line as other text) are always treated as inline elements.The plus alignment variants only apply on pages with layout: central or layout: blog. On other layouts they fall back to their non-plus equivalents.
YouTube
Embed a YouTube video by placing a YouTube URL on its own line. Retype automatically converts it into a responsive embedded player.
https://www.youtube.com/watch?v=dQw4w9WgXcQ
https://www.youtube.com/watch?v=VIDEO_ID
https://youtu.be/VIDEO_ID
https://www.youtube.com/embed/VIDEO_ID
Player parameters
Customize the embedded player by appending standard YouTube query parameters to the URL.
| Parameter | Example | Description |
|---|
autoplay | autoplay=1 | Start playback automatically |
loop | loop=1 | Loop the video |
controls | controls=0 | Hide player controls |
mute | mute=1 | Start with audio muted |
start | start=30 | Start at 30 seconds |
end | end=60 | Stop at 60 seconds |
https://www.youtube.com/watch?v=dQw4w9WgXcQ&start=30&end=60
Timestamps
Link to a specific time using the t parameter or the #t= hash format.
https://www.youtube.com/watch?v=dQw4w9WgXcQ&t=30s
https://youtu.be/dQw4w9WgXcQ?t=45
Embed
The [!embed] component renders an <iframe> (or similar HTML element) for any embeddable URL. It provides more control than the auto-YouTube embed.
[!embed](https://www.youtube.com/embed/C0DPdy98e4c)
AllowFullScreen
Full-screen support is enabled by default. Set allowFullScreen="false" to disable it.
[!embed allowFullScreen="false"](https://www.youtube.com/embed/C0DPdy98e4c)
Aspect ratio
Set the aspect ratio of the embedded area with the aspect attribute.
[!embed aspect="4:3"](https://www.youtube.com/embed/C0DPdy98e4c)
| Value | Description |
|---|
1:1 | Square |
4:3 | Standard |
16:9 (default) | Widescreen |
21:9 | Ultrawide |
Element type
Control which HTML element wraps the embedded content with the el attribute.
[!embed el="embed"](https://www.youtube.com/embed/C0DPdy98e4c)
| Value | Description |
|---|
iframe (default) | Standard iframe |
embed | HTML <embed> element |
video | HTML <video> element |
object | HTML <object> element |
Dimensions
Set explicit pixel dimensions with width and height.
[!embed width="300"](https://www.youtube.com/embed/C0DPdy98e4c)
[!embed height="120"](https://www.youtube.com/embed/C0DPdy98e4c)
Caption
Add a caption below the embedded content with the text attribute.
[!embed text="My Video Caption"](https://www.youtube.com/embed/C0DPdy98e4c)
