Los archivos readme de GitHub tienen la extensión MD, son de tipo Markdown o de marcado ligero cuyo principal objetivo es conseguir la máxima legibilidad y facilidad de publicación.
Cabe aclarar que realmente no es posible colocar vídeo de Youtube en el archivo README en GitHub lo que si es posible es colocar una miniatura de Youtube a la que si le dan clic se van al vídeo de origen.
Editar el Readme en GitHub
Desde tu repositorio a nivel local es perfectamente posible editar un archivo README.md y apenas los subas a GitHub el sistema va a entenderlo y acoplarlo para mostrárselo al usuario final, pero en este tutorial por sencillez vamos a editar el documento directamente desde GitHub en su portal web.
Desde que subes el repositorio a GitHub o creas un nuevo repositorio pulsando en el botón New, abajo en las opciones disponibles del portal, el sistema te ofrece la posibilidad de agregar el archivo Readme seleccionando un botón de chequeo.
Aunque si no lo seleccionas igual es perfectamente posible agregarlo y editarlo después. Basta con pulsar el botón donde dice Add a README para empezar a editarlo como se muestra en la pantalla a continuación:
Al pulsar en el botón Add a README el sistema para a un nuevo apartado donde hay dos pestañas con una pantalla de edición llamada Edit new file y otra de muestra llamada Preview como se puede ver en la pantalla a continuación:
Explicación en vídeo del proceso para insertar un vídeo en el readme de tu repositorio en GitHub
En el vídeo a continuación se explica todo el proceso del presente post:
Cómo colocar vídeo de Youtube en el archivo README en GitHubCódigo para colocar vídeo de Youtube en el archivo README en GitHub
El código para insertar una miniatura de Youtube con un enlace a tu vídeo subido:
[![Alt text](https://img.youtube.com/vi/configuroweb/0.jpg)](https://www.youtube.com/watch?v=configuroweb)
Se debe reemplazar el texto donde dice configuroweb por el id del vídeo de Youtube que quieres insertar. Es muy fácil y para esto voy a tomar uno de mis vídeos de Youtube relacionado con un post donde explico cómo usar Git y GitHub para administrar tus documentos a nivel avanzado
Si tomas la URL de arriba en el navegador te aparece el siguiente enlace:
https://www.youtube.com/watch?v=3RFAX3CbSGA
Si presionas el botón compartir te va a aparecer una URL diferente, se vería como se muestra a continuación:
https://youtu.be/3RFAX3CbSGA
Lo que tienen estas URL de vídeos de Youtube en común es el ID de vídeo, y es lo que vamos a reemplazar en el código. Donde dice configuroweb vamos a poner este ID.
El código a poner en el apartado de Edit New File en GitHub sería el siguiente:
[![Alt text](https://img.youtube.com/vi/3RFAX3CbSGA/0.jpg)](https://www.youtube.com/watch?v=3RFAX3CbSGA)
En GitHub al pulsar en la pestaña de Preview se debe visualizar una pantalla como la siguiente:
Al pulsar en este cuadrado GitHub te llevará a Youtube y reproducirá el vídeo sin inconvenientes.