Audios

Use audio blocks to embed a playable audio file. The block expands to fill the width of the content area and the user can play, pause and seek with the standard browser controls.

Basic syntax

At the start of a line:

!!!(assets/audio.mp3)
!!!(https://example.com/sound.mp3)

You can add optional CSS classes after the source, separated by a space.

Example

The audio player will fill the width of the content.

Here you can see more details about the supported audio sources (local files vs remote URLs).

Supported formats

The browser will use any format supported by the HTML5 <audio> element. The most common ones are:

• .mp3 -- the most widely supported format.
• .wav -- uncompressed, large file size.
• .ogg -- open container, well supported outside of some mobile browsers.
• .m4a -- commonly used by Apple devices.

When possible, ship both .mp3 and .ogg to cover the largest audience.

Accessibility tips

Note:

Always provide a transcript or a written description of the audio for users who cannot listen to it. Captions for audio-only content are usually published as a separate text file or page.

Note:

If the audio starts automatically (autoplay), make sure the page also offers a clear way to stop it -- many users find unexpected sound disruptive.