What can I put in a post?
A working guide to images, video, audio, code, tables and callouts in Markdown.
- Published
- Reading
- 1 minutes
- Topics
- Guide, Markdown
Bring your cursor closer; Uslu will join you.
Posts are plain Markdown files converted to HTML at build time. The same formatting works in project stories.
Images
Place media in public/media and use Markdown image syntax. A quoted title becomes a caption. Local image dimensions are included in the generated HTML.
Video and audio
Video extensions such as .mp4 and .webm become video players. Audio extensions such as .mp3 and .wav become audio players.
YouTube and Vimeo
Put a supported video link on a line of its own. YouTube embeds use the privacy-enhanced domain.
https://www.youtube.com/watch?v=VIDEO_IDCode
Specify the language after the opening fence. You can add a filename and highlight individual lines.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/", () => "Hello!");
app.Run();Tables and lists
| Format | Support |
|---|---|
| Tables | Yes |
| Task lists | Yes |
| Code highlighting | At build time |
- Write Markdown
- Preview locally
- Publish the next post
Callouts
Additional HTML
A little more detail
Raw HTML is supported in your own content files, including disclosure panels, keyboard labels and other semantic elements.