Breaking formatting on push

[jmduke]

Discussed in #6

^{Originally posted by jdhitsolutions June 5, 2025}
I wrote an email in Markdown. It was properly formatted with paragraphs and headings I used VS Code to write, format and preview. After I pushed, I opened the email in the web editor. It looked like everything was formatted as one long string of text. My paragraphs were all mashed together. I regret not taking a screenshot.

My expectation is that the email in the web editor would maintain the original formatting.

I am using v1.0.1 in a WSL Ubuntu instance on Windows 11. If it makes a difference, I double-checked and the file is encoded as UTF-8.

[linear]

CLI-3 Breaking formatting on push

[RichardDooling]

I have the same problem pushing on a Mac and using MacVim to write an email in Markdown. The text shows up in buttondown as a single block of text with paragraph breaks removed, backslashes before all hashtags, asterisks, and special characters. I have one email that I had to completely reformat. The other looks as described above in the editor, but displays properly in the viewer.. I sent the file to Justin.

[RichardDooling]

While I love the idea of writing Buttondown newsletters in MacVim, I'm reluctant to pull and push again because I don't want to get back single blocks of text. Maybe this feature is not used enough? Or not used enough by people on Macs?

[RichardDooling]

Gemini says to try this?

The issue of the buttondown CLI outputting a solid block of text without newlines on a Mac is typically a terminal display or shell configuration issue, rather than a problem with the CLI tool itself.

Here are the primary solutions to resolve this:

1. Adjust Terminal Settings (Temporary Fix)

A common cause is a misconfigured terminal setting regarding how it handles carriage returns (\r) and newlines (\n).

Run stty sane: This command resets your terminal driver settings to a sensible, default combination. This is often the quickest way to fix immediate display issues.

bash
stty sane

Run stty icrnl: This specific command tells the terminal to map carriage returns to newlines, which is usually the desired behavior.

bash
stty icrnl

After running one of these, try the buttondown command again.