Prepare Markdown for Beehiiv
Beehiiv reads Markdown from a plain paste. In a live test on 2026-08-24 the fixture produced native headings, nested lists, code blocks, two native tables, images, and links straight from a plain-text paste. Rich HTML also worked but was the worse choice: it mishandled front matter more severely and removed visible task state. So the Beehiiv handoff here is cleaned plain Markdown, not pre-rendered HTML.
Handoff mode: Clean Markdown paste. Tested in Beehiiv web Visual Editor. Tested 2026-08-24.Fixture markdown-portability-test-v1.See the record.
Prepare your draft
Your Markdown
Your draft stays in this browser. Nothing is uploaded.
Source context (optional)
Relative links and local files stay unresolved until you confirm where they point. Each unresolved target gets its own manual step rather than a guess.
How the Clean Markdown paste handoff works
The copy action writes cleaned Markdown as plain text. Cleaning means front matter removed, footnote and math content lifted into a checklist, Obsidian syntax flattened, raw HTML reduced to its visible text, and unsafe link schemes removed. What is left is the Markdown that Beehiiv own parser handles well.
What happens to each construct
| Rule | What happens | Result | Why | Confidence | Last tested |
|---|---|---|---|---|---|
BEE-FM-01 | Front matter is removed from the body. | Manual step | Pasted front-matter fields stayed as visible paragraphs in the tested editor. | Verified | 2026-08-24 |
BEE-LINK-02 | Relative and local links are not resolved. | Manual step | Without a confirmed base URL there is no safe way to know where these point. | Verified | 2026-08-24 |
BEE-IMAGE-02 | Local images do not upload. | Manual step | The local path stayed unresolved in the tested paste. | Verified | 2026-08-24 |
BEE-FOOT-01 | Footnotes are moved to a checklist. | Manual step | Footnote syntax stayed literal and an indented continuation became a code block. | Verified | 2026-08-24 |
BEE-MATH-01 | Math is moved to a checklist. | Manual step | No math or LaTeX control was visible in the tested editor. | Verified | 2026-08-24 |
BEE-OBS-01 | Obsidian syntax is flattened to ordinary text. | Manual step | Wiki links and transclusions stayed literal and callouts became plain quotes. | Verified | 2026-08-24 |
CORE-LINK-01 | A link with an unsafe scheme was removed; its text was kept. | Degraded | Only http, https, and mailto targets are carried. A javascript:, data:, or protocol-relative target is never copied into a destination editor. | Verified | 2026-08-24 |
BEE-TASK-01 | Task markers stay as text, not checkboxes. | Degraded | The tested editor left [x] and [ ] as literal characters. | Verified | 2026-08-24 |
BEE-MERMAID-01 | Mermaid stays as source code; no diagram renders. | Degraded | The tested editor showed the fence as a code block. | Verified | 2026-08-24 |
BEE-HTML-01 | Raw HTML is removed; its visible text is kept. | Degraded | Raw paste showed literal markup in the tested editor. | Verified | 2026-08-24 |
BEE-HEAD-01 | Headings become native headings. | Kept | The tested paste converted H1 through H6 into native blocks. | Verified | 2026-08-24 |
BEE-EMPH-01 | Inline formatting is kept as Markdown. | Kept | The tested editor parsed emphasis, strike, and inline code from a plain paste. | Verified | 2026-08-24 |
BEE-LINK-01 | Absolute and mailto links are kept. | Kept | Both survived the tested paste. Preview cards remain destination-controlled. | Verified | 2026-08-24 |
BEE-LIST-01 | Lists and nesting are kept. | Kept | Three tested nesting levels survived the paste. | Verified | 2026-08-24 |
BEE-QUOTE-01 | Quotes and dividers become native blocks. | Kept | Both converted in the tested paste. | Verified | 2026-08-24 |
BEE-CODE-01 | Code is kept, but a long unbroken line may overflow in email. | Kept | Fenced code converted natively; long lines needed review in the tested narrow and email previews. | Verified | 2026-08-24 |
BEE-TABLE-01 | Small tables become native tables. | Kept | The tested editor built a native table from a pasted GFM table. | Verified | 2026-08-24 |
BEE-TABLE-02 | A wide table wraps tightly in email. | Kept | Cells wrapped hard in the tested desktop and mobile email previews. | Verified | 2026-08-24 |
BEE-IMAGE-01 | Remote images import, but alt text is not confirmed. | Kept | The platform imported the file; the test did not verify that alt text survived. | Verified | 2026-08-24 |
BEE-ANCHOR-01 | Heading anchor links are kept but may be rebound. | Kept | The tested platform rewrote the anchor onto its own draft-preview URL. | Verified | 2026-08-24 |
BEE-BREAK-01 | Hard breaks add extra vertical space. | Kept | The tested paste turned one hard break into two line breaks. | Verified | 2026-08-24 |
Where Beehiiv usually goes wrong
Footnotes break in a specific way
Reference syntax stayed literal and an indented continuation was misclassified as an HTML code block. Beehiiv has a native Footnotes component that rendered correctly in both previews, so the repair is real and quick.
There is no math control
Inline and block math stayed literal and no math or LaTeX option appeared anywhere in the full insertion menu. The formula source is kept in a checklist so you can add it as an image with a text alternative.
Wide tables get tight in email
A nine-column table became a native table, but its cells wrapped hard in both the desktop and mobile email previews. The table survives; the readability needs your eyes on the preview.
Alt text is not confirmed
The remote image was imported to Beehiiv storage, but the test did not verify that alt text survived. This tool will not claim Beehiiv preserves alt text until a focused test says so, so it asks you to check.
Evidence from the test
Limits of what was tested
- Built-in email and web previews were inspected; no email was sent and nothing was published.
- A native Footnotes component and an HTML snippet rendered in previews, but no verified clipboard path into them exists.
- No math or LaTeX control was visible.
- Alt-text behavior needs a focused test before any preservation claim.
A live result proves the tested surface on the tested date. Rendering is not identical across platform versions, themes, plugins, or email clients, and link preview cards are controlled by the destination.