Turn Markdown and HTML files into an audio show
Upload a Markdown or HTML file, or paste a link to the page, and get a narrated audio show. Ask Lissin to skip code blocks or explain what they do.
The short answer
Upload the .md or .html file on Plus or Pro, or paste a link to the published page on any plan, then describe the show you want. Lissin writes a spoken script from the text, so asterisks, backticks and link brackets are not read out. For a whole docs site, combine the pages you care about first.
How to do it
Upload the file, or link to the published page
Markdown and HTML files upload directly on Plus and Pro. If the docs are already published, pasting the link works on any plan and picks up the rendered tables and link text.
Save a web page properly
Save Page As → Web Page, Complete gives an HTML file with the article text intact. Switch to Reader mode first where the browser offers it. It strips navigation and related-article links, which would otherwise be narrated as part of the piece.
Decide what to do with code
Code blocks read aloud badly and at length. Say ‘skip the code, explain what it does’, or for a tutorial, ‘describe each step without reading the snippets’.
At a glance
- Sources it takes
- A link, pasted text, or an upload on Plus and Pro: Markdown, HTML, text, PDF, DOC, DOCX, PPTX, XLSX, EPUB
- Markdown
- Upload the .md file directly
- Docs sites
- Concatenate pages into one HTML file
- Transcript
- Included, synchronised to the audio
Hear what comes out
Shows already published on Lissin, free to play in the browser.
Questions
- Can I upload the .md file directly?
- Yes, on Plus or Pro. Lissin takes the text from the file and writes a spoken script from it, so formatting symbols do not end up in the audio. You do not need to render it to HTML first.
- Can I give it a URL instead of a file?
- Yes. Paste the link and Lissin fetches the page itself. Save the page as a file when Lissin cannot reach it: a page behind a login, a paywalled article, or one that renders its text only after JavaScript runs.
- What about a whole documentation site?
- Concatenate the pages you care about into one HTML file. A README plus a getting-started guide plus an architecture page is a reasonable episode; a full API reference is not.
What this does not do
Interactive pages lose whatever the interaction carried. Saved pages sometimes include the site’s navigation menus, which show up as odd fragments in the script. And a paywalled article does not become readable by being saved.
Make your own show, or hear a sample
Make a show from your topic or documents in the Lissin iPhone app (iOS 26 or later). Or listen to public shows in the web player without installing the app.
Last reviewed October 20, 2026 by Lissin Editorial.