DEV Community

Cover image for Embedding Videos in Markdown using React
Rayza Oliveira for ttoss

Posted on • Updated on • Originally published at

Embedding Videos in Markdown using React

In modern web development, rendering rich content like videos within markdown files is a common requirement. This post demonstrates how to work with videos inside markdowns using React, utilizing a custom React component.


Firstly, ensure you have a React project set up. In this demonstration, we're using a custom Markdown component from the @ttoss/component package, which is based on react-markdown.

import { Markdown } from '@ttoss/component'; // based on react-markdown
Enter fullscreen mode Exit fullscreen mode

Creating a Markdown Content Component

Let's create a MarkdownContent component to render the content. This component accepts a content prop which is the markdown content as a string.

type MarkdownContentProps = {
  content: string;

export const MarkdownContent = ({ content }: MarkdownContentProps) => {
  // component body
Enter fullscreen mode Exit fullscreen mode

Customizing the Markdown Component

The Markdown component from @ttoss/component allows us to customize the rendering of HTML elements. In this case, we're interested in customizing the rendering of anchor (<a>) elements to embed YouTube videos.

    a: (props: any) => {
      // custom rendering
Enter fullscreen mode Exit fullscreen mode

Obtaining the Embed Link from YouTube

To embed a YouTube video, you need to obtain the embed link for the video. Follow these steps:

  1. Go to the video on YouTube.
  2. Click on "SHARE" below the video.
  3. Click on "Embed".
  4. Copy the URL from the provided code. The URL will be in the format:

Handling Video Links

We need to identify links that are meant to embed videos. In this example, we check if the href attribute of the anchor element contains the strings 'youtube' or 'embed'.

if (['youtube', 'embed'].every((item) => props.href.includes(item))) {
  // custom rendering for video links
Enter fullscreen mode Exit fullscreen mode

Embedding the Video

For links identified as video links, we return a custom component structure to embed the video within an iframe.

return (
      position: 'relative',
      paddingBottom: ['56.25%', 'calc(56.25% * 0.75)'],
      width: ['unset', '75%'],
      height: 0,
      margin: '0 auto',
        border: 'none',
        position: 'absolute',
        top: 0,
        left: 0,
        width: '100%',
        height: '100%',
      // @ts-ignore
Enter fullscreen mode Exit fullscreen mode

Usage Example

Here is an example of how you can use the MarkdownContent component with a YouTube video:

const videoMarkdownContent = `
# My Favorite Video
Here is my favorite YouTube video:
[a video](

function MyApp() {
  return <MarkdownContent content={videoMarkdownContent} />;

export default MyApp;
Enter fullscreen mode Exit fullscreen mode

In this example, replace VIDEO_ID with the YouTube video ID you want to embed.


This setup allows you to render markdown content with embedded videos in a React application, providing a rich content experience. By customizing the rendering of markdown elements, you can handle various content types and create a tailored viewing experience for your users.

Top comments (0)