Why this Markdown workflow breaks on iOS

iPad is a good screen for project documentation, but a downloaded README.md file may show raw Markdown instead of rendered headings, code blocks, and tables.

The shortest answer

Install Md Preview, open the file from Files, the Share Sheet, or the source app, and preview it locally. The app has no subscriptions, no in-app purchases, and no ads.

The GitHub README files on iPad workflow

Save README.md to Files, share it to Md Preview, and read the rendered documentation locally on iPad.

What to check before opening

This is for downloaded or shared README files; normal GitHub web pages can still open in a browser.

Why local preview fits this job

Md Preview is focused on file preview. It avoids uploads, account setup, ad clutter, and heavy editing features when the user simply needs to read a Markdown file now.

If you also receive HTML files

AI and document workflows often produce both Markdown and HTML. Html Preview is the companion viewer for that file type.