# How to publish Markdown with mermaid diagrams online

> Drop the .md file into ArtifactSend. Every ```mermaid block draws as a diagram, next to your tables and highlighted code, on a page anyone can open with the link. GitHub also draws mermaid in Markdown, but only inside GitHub, for people who can see the repository or gist.

Updated November 13, 2026. By Vela Partners. https://artifactsend.com/guides/publish-markdown-with-mermaid

## Free here, side by side

Everything here is free on ArtifactSend, with no limits on documents, links, readers or team members. The same set costs €59 a month on Papermark, or €708 a year.

| Tool | What this set costs |
| --- | --- |
| ArtifactSend | $0, free, no card, no trial |
| DocSend | $10 a month ($120 a year) per user, 1 not listed |
| Papermark | €59 a month (€708 a year) |
| Peony | Free plan, capped at 1 admin, 50 documents, 500 MB, 30 days of analytics |
| Digify | $140 a month ($1,680 a year), 2 not listed |

Covers Live HTML pages and Claude artifacts · Password on a link · Email before viewing · How far each reader got, and time per section

Rival facts from each vendor's public pricing and feature pages, November 2026, prices billed yearly. Not listed means the vendor's pages do not say. Prices change, so check theirs before you decide.

## The short answer

1. Open artifactsend.com/markdown-viewer and drop the file. The diagrams draw in the preview.
2. Select Get a shareable link and sign in.
3. Choose who can open it and send the link.

## What renders

- Mermaid flowcharts, sequence diagrams, Gantt charts and the other mermaid diagram types, in light or dark.
- Tables, task lists and GitHub callouts such as > [!NOTE].
- Code blocks with syntax colors.
- Front matter at the top, used as the title.

## GitHub or a link?

GitHub's docs say you can create diagrams in Markdown with mermaid, and they render in issues, pull requests, files and gists. Readers see them on GitHub. A public repository or a secret gist is visible to anyone with the address, which GitHub's own docs point out for gists.

Send a link when the readers are not on GitHub, when the content is private, or when you want to know who read it.

## Questions

**Does it work on a phone?**

Yes. Diagrams scale to the screen.

**Can I update the diagram later?**

Yes. Replace the file and the link stays the same.

**Is it free?**

Yes.

## Sources

- [GitHub Docs: Creating diagrams](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams)
- [GitHub Docs: Creating gists](https://docs.github.com/en/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists)
