Why this Markdown workflow breaks on iOS

README files are meant to be read as rendered Markdown. When they are downloaded or shared as files, iOS may show raw syntax instead.

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 workflow

Download or save README.md, open it from Files, and preview the rendered Markdown in Md Preview.

What to check before opening

This is useful for developers, students, and anyone reading project documentation on iPhone or iPad.

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.