‍ How to Add an Embedded Video to Github Readme File
Tags: opensource, plugins, github, intellij
Published: 2022-06-13 06:52:14

---
title: ‍ How to Add an Embedded Video to Github Readme File
published: true
date: 2022-13-06 09:53:04 UTC
tags: opensource,plugins,github,intellij
canonical_url: 
---

### How to Add an Embedded Video to Github Readme Files

![](https://cdn-images-1.medium.com/max/1024/1*-zO5GC_wdGUDuOb6R-IelA.jpeg)
_Source_

**Hi everyone 🖐.** In this article, I wanna show to you how you can add an embedded video into your readme files easily.

When you added a video to your readme file as below

- Option One

```
[![Now in Android: 55] // Title
(https://i.ytimg.com/vi/Hc79sDi3f0U/maxresdefault.jpg)] // Thumbnail
(https://www.youtube.com/watch?v=Hc79sDi3f0U "Now in Android: 55") // Video Link
```

- Option Two

```
[<img src="https://i.ytimg.com/vi/Hc79sDi3f0U/maxresdefault.jpg" width="50%">](https://www.youtube.com/watch?v=Hc79sDi3f0U "Now in Android: 55")
```

you will see a view as below. When a user clicks a thumbnail that exists in your readme file the user will be navigated to another website.

![](https://cdn-images-1.medium.com/max/600/1*VitByKjas2fYCI24Gc4Clw.gif)

Actually, this is not an embedded video because for watching the video user must navigate to another website, and of course, we don’t want this in order to don’t lose the focus of the user.

So how we should add an embedded video? Dou you ready for the magic worlds??

> Just “ **Drag & Drop** ” 😄

![](https://cdn-images-1.medium.com/max/600/1*a2fC7zy5F1O6ITaA48Cwkw.gif)

In this way, you can add an embedded video to your readme files easily without losing users' focus because they will not go to another website for viewing your video. And this video view can be collapsed- expanded. And also your users can change the volume of the video and watch your video on full screen.

You can also add your **images** with this method.

**Keep in mind** the [**maximum file size**](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/attaching-files) is 10MB for images and gifs. 10MB for videos on a free GitHub plan. 100MB for videos on a paid GitHub plan.

**Finally** , I wanna suggest that use the GitHub website (such as I showed in the gifs) instead [Markdown plugin](https://plugins.jetbrains.com/plugin/7793-markdown) with Intellij IDE when you prepare a readme file for your repo. Because sometimes it is not working properly and features such as drag & drop is not supported for videos (The plugin supports drag & drop for images). This feature is provided by the Github website. That’s why the result of the same readme file might be different in Intellij IDE and the Github website. I wasted my time by using the plugin.

#### **Conclusion**

We learned how we can add a real embedded video to our readme files easily by Drag & Drop feature provided by Github. If you like the article please clap the article and share it. See you in the next articles. Stay tuned.

#### References

- [Video uploads now generally available | GitHub Changelog](https://github.blog/changelog/2021-05-13-video-uploads-now-generally-available/)
- [Attaching files - GitHub Docs](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/attaching-files)

* * *