Markdown, HTML, and BBCode Embeds: Share Files on Any Platform

A shared file is only useful if people can actually see it where they're working. Paste a bare link into a forum and you get a click; paste an embedded snippet and you get the file itself, rendered inline. That difference — between a link and an embed — is what turns a hosted file into something people actually use.

Every file hosting service returns a URL. Fewer give you the exact syntax each platform needs. This guide covers the three embed families — Markdown, HTML, and BBCode — and how to use them for images, video, audio, and PDFs.

What is an embed snippet?

An embed snippet is the small piece of syntax a platform uses to render a file or media element inside a page. Instead of telling people to click a link, the snippet places the content directly where they're already reading.

ShareKit generates copy-ready snippets with every upload. Upload an image, video, audio file, or PDF and the results include the exact Markdown, HTML, and BBCode you need — no hand-writing syntax, no hunting for the right format.

Markdown embeds: Notion, GitHub, and documentation

Markdown is the default format for documentation, READMEs, Notion pages, and most knowledge bases. The syntax is deliberately simple:

• Images — ![alt text](https://sharekit.app/image.png)
• Links — [Watch the demo](https://sharekit.app/clip.mp4)
• Audio — [Listen to the episode](https://sharekit.app/episode.mp3)

An image embed renders the picture inline; a link embed opens the destination on click. For documentation and team wikis, the image embed is the workhorse — screenshots and diagrams belong in the page, not behind a click. The image to URL workflow returns Markdown snippets for exactly this.

HTML embeds: websites, blogs, and email

HTML gives you control over how media renders. The two tags that matter:

• Images — <img src="https://sharekit.app/photo.png" alt="Product photo" width="800">
• Video — <video src="https://sharekit.app/clip.mp4" controls></video>
• Audio — <audio src="https://sharekit.app/episode.mp3" controls></audio>

Video and audio embeds give visitors an inline player without any third-party widget. This is how product demos end up on landing pages, how training clips end up in internal tools, and how reference audio ends up in review pages. The video to URL and audio to URL guides cover the workflow in detail.

For PDFs, the embed is usually a link with context rather than an inline viewer — but the hosted preview page means the recipient sees the document immediately when they click.

BBCode embeds: forums and communities

BBCode survives wherever forums survive — Reddit-style communities, phpBB boards, and support communities still use it:

• Images — [img]https://sharekit.app/screenshot.png[/img]
• Links — [url=https://sharekit.app/manual.pdf]Download the manual[/url]

The [img] tag renders the image inline in the post. This is the fastest way to share screenshots and product images with a community without uploading a duplicate copy to the forum's own file storage.

Which snippet should you use?

The rule is simple: match the snippet to the destination.

| Destination | Snippet | Example | | --- | --- | --- | | Notion, GitHub, READMEs, wikis | Markdown | ![alt](url) | | Websites, blogs, email | HTML | <img> / <video> / <audio> | | Forums, community boards | BBCode | [img]url[/img] | | Chat, tickets, social | Plain link | paste the share URL |

The same uploaded file works in every column — that's the point of generating all three snippets at upload time rather than converting later.

Embedding different file types

The snippet type depends on the file, not the platform:

• Images render inline everywhere. This is the most common embed because screenshots, diagrams, and product photos belong inside the content.
• Video embeds need a player. The <video> tag is supported in every modern browser, so inline playback works without plugins.
• Audio embeds behave the same way, with an <audio> tag and browser-native controls.
• PDFs are best linked with context, letting the hosted preview page do the presentation.

If you're embedding across a workflow — a screenshot in a Notion page, a demo in a landing page, a recording in a support article — the copy-ready snippets keep every destination in sync with one hosted file.

Common embed mistakes

Three mistakes cause most broken embeds:

1. Wrong syntax for the platform. A BBCode [img] tag won't render in GitHub. Copy the snippet marked for your destination.
2. Forgetting the alt text. Accessible embeds describe the image — useful for SEO and screen readers, and required in many documentation standards.
3. Embedding without checking the file. Preview the hosted file once before pasting the snippet everywhere, so a typo doesn't propagate across ten pages.

Embeds and analytics

Every embed points at the hosted page, so embedded content reports back. When a viewer opens the embedded image, video, or audio on your site, the view is counted on the file's analytics alongside direct opens, downloads, and QR scans. That means an embedded demo video, an inline screenshot, and a printed QR code all report to the same file — you see how the file performs across your website, your documentation, and your print materials without stitching numbers together from separate tools. This is why embedding is not just a formatting convenience; it's part of the measurement loop. The file sharing analytics guide explains how to read those numbers.

FAQ

What is an embed snippet? The small syntax a platform uses to render a hosted file inline — Markdown for docs, HTML for websites, BBCode for forums.

How do I embed an image in Markdown? Use ![alt text](image-url). ShareKit provides this snippet automatically with every image upload.

How do I embed a video on my website? Use the HTML <video src="..." controls></video> snippet from the upload results.

Does the embed keep working if the file changes? Yes. The snippet points at the hosted address, so replacing the file at that address updates everywhere the snippet is used.

Can I embed audio files? Yes. The HTML <audio> snippet adds a browser-native player to any page.

What is BBCode used for? Forums and community boards use BBCode tags like [img] and [url] to render images and links inline.

Do embeds work on mobile? Yes. Browser-native players and image rendering work on every device.

Do embedded files affect analytics? Yes. Opens of the hosted page through embeds count as views on the file, alongside downloads and QR scans. Can I use the same file in multiple embed formats? Yes. Every upload generates Markdown, HTML, and BBCode snippets for the same hosted file.

Do embeds work in email newsletters? Most clients block remote embeds, so use the share link with a preview image for email, and reserve inline embeds for web and documentation.