Is there a way to add an audio player in a GitHub readme.md? I want to be able to play a certain MP3 file directly through the readme.md, rather than be directed to some SoundCloud or YouTube link.
Add a comment
|
4 Answers
As of May 2021, GitHub supports video uploads, and sort of supports audio uploads. While you cannot directly upload .wav or .mp3 files to GitHub, uploading a .mp4 or .mov file containing only audio gives an (albeit poorly-formatted) audio player:
You can convert .wav and .mp4 files into compatible video files with freeconvert.com or any similar converter.
Comments
Update May 2021: as I already reported in "How to embed a video into GitHub README.md?", "Video uploads now is generally available"
Original answer 2017:
No, as I documented before, an <audio> element (or video) is not supported in GitHub Markdown.
For video, a workaround is to use an animated GIF, but for audio, having a placeholder linking to the actual audio seems to be the only way.
Comments
I had been struggling with this, GitHub does not support the <audio> tag in Markdown. Therefore, I decided to create a simple GitHub Pages site that reads the audio URL from the query string
https://gabalpha.github.io/read-audio/?p=<audio_url>
example
[Link text](https://gabalpha.github.io/read-audio/?p=https://archive.org/serve/TimeTraxMD/01.%20Music%2000.mp3)
You can embed this link within your markdown file
I hope it can be useful!
Comments
As of Nov 2024, you can just rename your mp3 to mp4 and upload it in the built-in editor:
It plays just fine, at least for me. (Not sure if it was this way all along or was just recently made possible.)
