Markdown files

How do I open a Markdown file on iPhone?

Open a Markdown .md file on iPhone as formatted text with headings, lists and code blocks instead of raw symbols. Compare the options and see the steps.

Short answer

To open a Markdown file on iPhone as formatted text, share the .md file to an app with a Markdown preview. HTML Keep renders .md and .markdown files natively, so headings, lists, links and code blocks look the way the author intended, and the file stays in a searchable library.

Why .md files look like plain text on iPhone

Markdown is plain text with light formatting symbols: # for headings, * for lists, backticks for code. It is meant to be converted into formatted text by whatever displays it.

When you open a Markdown file on iPhone through the Files app, you typically see the raw text with all the symbols showing. It's readable, but long documents like a README, meeting notes or an AI-written report become hard to scan.

Raw Markdown versus a rendered preview

Here is the difference in practice. In raw form, a heading appears as a line starting with ## Project goals, a list is a column of lines starting with dashes, and a link shows as text in square brackets followed by a web address in parentheses.

Rendered, the same file shows Project goals as a real heading, the dashes become bullet points, and the link becomes a single tappable phrase. Code samples sit in their own shaded blocks instead of blending into the paragraphs around them.

For a two-line note, raw text is fine. For a ten-page specification or a long AI summary, the rendered version is the difference between skimming and squinting.

Where Markdown files come from

You might not think of yourself as a Markdown user, yet these files turn up often.

  • Project READMEs and documentation downloaded from a code repository.
  • Notes exported from note-taking apps that store pages as .md.
  • Summaries, plans and reports that AI assistants offer as a downloadable .md file.
  • Course materials and changelogs shared by colleagues.

Each of these is far easier to read once it's rendered with real headings and lists.

Reading a Markdown file with HTML Keep

HTML Keep is best known for HTML pages, but it also opens Markdown with a native rendered preview.

  1. Install the app from the download page.
  2. Locate the .md or .markdown file in Files, Mail, Messages or a chat app.
  3. Tap Share and choose HTML Keep.
  4. The document opens formatted: headings, bold and italic text, lists, links, quotes and code blocks.
  5. It's saved as a project in your library, so you can find it later by name or by words in the text.

If you prefer to start in the app, tap Open File and pick the document from Files.

Tips for Markdown on iPhone

  • Search inside your notes: the app indexes the body text of Markdown files, so searching a phrase finds the document even if you forgot its name.
  • Keep related files together: if a README links to images in a folder, zip the folder and open the ZIP so everything stays in one project. See opening ZIP web projects.
  • Got a newer version? Open the updated file with the same name and choose to update the existing project, which keeps one previous version.
  • Can't remember the file name? Search in the app looks inside Markdown text too, so a phrase from the note is enough to find it.
  • Want to change the text? This is a viewer, so edit the file in a text editor and re-import it.

When Markdown and HTML arrive together

AI tools often produce both: a Markdown explanation and an HTML page or app. Keeping both in one place saves switching between apps. For the HTML side, viewing AI-generated HTML on your phone walks through the details.

If you mostly receive web pages, start with opening an HTML file on iPhone. HTML Keep handles both file types the same way: share, open, and find it again in your library.

Frequently asked questions

Can I edit Markdown in HTML Keep?

No. It shows a rendered preview for reading. Use a text or Markdown editor to make changes.

Does it support .markdown as well as .md?

Yes, both extensions open with the rendered Markdown preview.

Can I read the Markdown on my iPad too?

Yes. With iCloud sync turned on and the same Apple Account, your library can continue between iPhone and iPad.

Will images in my Markdown file show up?

Images need to be reachable from the file. Keep them in the same folder structure, ideally by opening a ZIP of the whole folder.

Is the Markdown file changed when I open it?

No. The preview only displays the note. Your original .md file stays exactly as it was, so you can keep editing it elsewhere and re-import the new version.

Android updates

Leave your email and we will notify you when Android testing or Google Play access opens.

We will only use this email for Android availability updates. Privacy