# How to send a .md file to someone who's never seen one

> Which format to send when you share a .md file (PDF, Word, the .md or a link), what to say with it, and how to keep one version everyone trusts.

Source: https://oneclearreader.com/guides/share-markdown-file · Updated 28 September 2026 · One Clear Reader (Northlight Group Pty Ltd)

> [!answer] When you send a .md file to someone who's never seen one, send the format that matches what they'll do with it: a PDF to read or print, a Word file to edit, and the .md itself only for a developer or another AI tool. If you do send the .md, add one line saying it's a plain text document that opens in any text app.

## What will someone see if I just send them a .md file?

Someone who opens a .md file you send will most likely see a page of symbols. A .md file is plain text, so on a Mac it usually opens in TextEdit, and on a phone it shows as plain text in the Files app. Headings arrive as `#`, bold as `**`, and tables as rows of `|`.

Nothing is broken, and the file is harmless. But to someone who has never seen Markdown it can look like a mistake, or like something they shouldn't open. That's the real cost: a confused reply, or no reply.

If they're curious, [what a .md file is](/guides/what-is-a-md-file) is a friendly place to send them.

## Which format should I send a .md file in?

The right format for sharing a .md file depends on who's getting it. This table matches the person to the format: pick the row that fits, then send what's in the middle column.

| You're sending it to | Send this | Why |
|---|---|---|
| A boss, client or relative who just needs to read it | **PDF** | Looks the same on every device, prints cleanly, can't be changed by accident |
| A client who expects something polished | **PDF with a cover page** | Title, who it's for, who it's from and a date on page one |
| Someone who will edit it or track changes | **Word (.docx)** | Opens in Word, Pages and Google Docs, and they can mark it up the way they're used to |
| A team that works in Google Docs | **A Google Doc** (import the .md, share the link) | They can comment in the place they already work |
| A team on Microsoft 365 | **The .md, uploaded to OneDrive or SharePoint** | These now show and edit .md files formatted in the browser ([Microsoft, April 2026](https://techcommunity.microsoft.com/blog/onedriveblog/introducing-markdown-support-in-sharepoint-and-onedrive/4512174)) |
| A developer | **The .md** | It's their native format. They'll read it in their editor |
| Another AI tool (Claude, ChatGPT, Cursor) | **The .md** | AI tools read Markdown directly. A PDF or Word file only adds conversion |
| Someone reviewing it with you in One Clear Reader | **The .md plus its .notes.md** | Your notes open beside the document for them |

When in doubt, send a PDF. It's the one format almost everyone can open without help.

> [!scribble] match the file to the person, not the tool.

## How do I turn a .md file into a PDF or Word file to send?

Turning a .md file into a PDF or Word file takes a minute once you know the route. Free options include Pandoc, VS Code with an extension, and Google Docs. The step-by-step guides are here:

- [How to turn a .md file into a PDF on a Mac](/guides/markdown-to-pdf-mac), including printing and a PDF with a cover page.
- [How to turn a .md file into a Word document](/guides/markdown-to-word), including what to do when they send it back.

In One Clear Reader, Save as PDF, Save as client PDF and Save as Word are one command each (Pro).

## What should I say when I send a .md file?

When you send a .md file, say what it is, say that the symbols are normal, and offer another format. Copy this and change the names:

```text
Hi Sam,

I've attached plan.md. It's a plain text document (Markdown),
so it opens in any text app, like TextEdit or Notepad.

If you see # and * symbols, that's normal: # marks a heading
and ** marks bold text.

If you'd rather have it as a PDF or Word file, just say and
I'll send one.
```

For a developer or an AI tool, you can skip all of that. "Plan attached as Markdown" is enough.

## How do I send my review notes with a .md file?

To send review notes with a .md file, save the notes as a file and send both files together.

In One Clear Reader, select some text and press ⌥⌘N to **Add note**. Free gives you 3 notes per document, Pro unlimited. When you're done, open the **Review** panel and choose **Save as file**. It writes `plan.notes.md` next to `plan.md`.

Send both files and ask them to keep them in the same folder. When they open `plan.md` in One Clear Reader, it spots the notes file and offers **Show them here**. If they don't use One Clear Reader, the .notes.md is readable Markdown, so they can still read your notes as text.

If the notes are for an AI rather than a person, **Copy as prompt** in the same panel copies the file path, each quoted passage and each note as one message you can paste into Claude or ChatGPT.

## Can I point someone at one section of a .md file?

Yes, you can point someone at one section of a .md file if they have the same file on their Mac. Otherwise, name the heading in words.

In One Clear Reader, hover over a heading and click the **#** that appears. It copies the file's path with the section on the end, like `/Users/maya/Documents/plan.md#rollout`. That's useful for an AI tool or a developer working on the same Mac: paste it into Claude Code so it knows which part you mean.

It's a path on your Mac, not a web link, so it won't open for someone on a different computer. For them, write "see the Rollout section" and send the PDF.

## How do I keep one version of a shared document everyone trusts?

To keep one version everyone trusts, pick one file as the master and make everything you send a copy of it.

- **Keep the .md as the master** while you and your AI are still working on it. Edit the .md, then export a fresh PDF or Word file each time you send it.
- **Date the copies.** `launch-plan-2026-10-01.pdf` tells everyone which version they have. `launch-plan-final-v3.pdf` doesn't.
- **Never edit the PDF.** Change the .md and export again.
- **When edits come back in Word**, bring them home to the .md. [What to do when someone sends back a Word file](/guides/markdown-to-word) covers the options, including a free Markdown copy.
- **Hand over the master on purpose.** If a team is going to own it in Word or Google Docs from now on, say so, and stop editing the .md.

A shared link can help here too. A file uploaded to OneDrive stays one .md that everyone views and edits. A Google Docs import, on the other hand, is a separate copy, so decide which one is the master before people start commenting.

## Questions

### Can someone without a Markdown app open a .md file?

Yes. Any text app opens it, including TextEdit on a Mac and Notepad on Windows. They'll see the # and ** symbols instead of formatting, which is why a PDF is usually the kinder choice.

### Should I send a PDF or a Word file?

Send a PDF if they only need to read or print it. Send Word if they need to edit it or suggest changes, because a PDF is hard to edit.

### Is it safe to send a .md file by email?

Yes. A .md file is plain text and can't run anything by itself. It's also tiny, so it attaches easily.

### What's the best format to give another AI tool?

The .md file. Claude, ChatGPT and Cursor read Markdown directly, and it keeps the headings, lists and tables they need. Converting to PDF or Word first adds work and can lose structure.

### How do I share a markdown file as a link?

Upload the .md to OneDrive or SharePoint and share it, since Microsoft now shows .md files formatted in the browser. Or import it into Google Docs and share the Doc, which makes a separate copy.