23

Is there a way to add an audio bar in the 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.

Sarthak Agarwal
  • 404
  • 1
  • 3
  • 13

2 Answers2

7

Update May 2021: as I already reported in "How to embed a video into GitHub README.md?", "Video uploads now is generally available"

video upload


Original answer 20217:

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.

VonC
  • 1,262,500
  • 529
  • 4,410
  • 5,250
7

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: Audio player

You can convert .wav and .mp4 files into compatible video files with freeconvert.com or any similar converter.

Gavin Uberti
  • 393
  • 4
  • 8