DEV Community

Cover image for Your markdown doesn't survive the trip: formatting gotchas for X, LinkedIn, newsletters & blogs
Writeous
Writeous

Posted on

Your markdown doesn't survive the trip: formatting gotchas for X, LinkedIn, newsletters & blogs

You wrote a great post in markdown. Clean headings, tidy links, a code block or two. Then you go to share it — and the real work begins.

Because markdown doesn't survive the trip. Each platform mangles it a different way, and "just paste it" quietly breaks your formatting in four directions at once. Here's what actually happens, platform by platform.

X / Twitter — there is no markdown, and there's a wall at 280

Paste your post and your **bold** becomes literal asterisks, your headings vanish into the void, and your 1,200-word essay becomes one un-tweetable blob. To thread it properly you have to manually chop it into ≤280-char segments, decide where the breaks land, lead with a hook, and number them so people can follow. By hand, every time.

LinkedIn — it renders no markdown, and rewards skim-ability

LinkedIn strips it all: no #, no **, no [text](link). Headings collapse, emphasis disappears, and link syntax shows up as raw [brackets](and-parens). The format that works is the opposite of a blog — short lines, generous whitespace, a hook in the first two lines before the "…see more" fold.

Your newsletter — structure, not styling

Email clients are a formatting minefield, so newsletters want simple structure over rich markup: a subject line (which your markdown doesn't have), short paragraphs, clear sections. A wall of blog prose lands very differently in an inbox.

Your blog — the one place markdown belongs… mostly

Here your hierarchy and links should survive — if your renderer is configured for it. But images, relative links, and footnotes are where pastes silently drop things.


The through-line: the writing was done the moment you finished the draft. Everything after is reformatting labor — the same idea, reshaped four times, by hand, every single time you publish.

That's the problem I got tired of, so I built Writeous: paste one markdown file, get a blog post, a newsletter, an X thread (auto-split, numbered, hook-first), and a LinkedIn post (markdown stripped, built to skim) — each formatted right for where it's going, in about 60 seconds. No login to try it.

Writeous turning one markdown file into a blog post, newsletter, X thread, and LinkedIn post in seconds

This very post? Written as one markdown file. The X and LinkedIn versions promoting it were made by Writeous itself.

Write once. Publish everywhere. Actually.

Top comments (0)