Markydowny

FAQ

#Is Markydowny free?

Yes. The website and the Mac app are free, and the source is on GitHub.

#Are my files uploaded anywhere?

No. Files are read on your device, in your browser or in the app, and never sent anywhere. There are no analytics. See Privacy.

#Why don't my images show up?

On the web, drop the folder that holds the document, not just the file. A browser only lets the page read the files you give it, so a single file can't reach the images next to it. In the Mac app, relative images resolve from the file's location automatically. See Relative images and links.

#Why doesn't the page update when my file changes?

Live reload on the web needs a Chromium browser (Chrome, Edge, Brave, Arc, Opera…) and a file opened with Choose File or dropped on its own. Safari and Firefox read the file once, and a dropped folder is read once. The Mac app always live-reloads. See Browser support.

#Why did the page stop scrolling to changes?

You scrolled, which pauses Follow so the page doesn't jump away from what you're reading. Click Resume.

#Why does Save download a copy?

Your browser can't write files in place (Safari, Firefox), or the file came from a dropped folder. Open the file with Choose File in a Chromium browser, or use the Mac app, to save in place. See Save.

#Will saving reformat my markdown?

No. Only the text you changed is different; line endings, spacing and everything else stay as they were. See Only your edits change.

#Which files can it open?

.md and .markdown files, plain .txt files and other text files. The Mac app registers as a viewer for .md, .markdown, .mdown, .mkd and .mkdn.

#Does it run scripts or HTML in my markdown?

HTML in a markdown file is rendered in both.

#Is there a Windows or Linux app?

Yes. Linux has .deb and .AppImage packages for x86_64 and arm64, and Windows has an installer for 64-bit Windows 10 and 11, both on the Download page. The website also works in any browser on any system.

#Why can't I find it in the Mac App Store?

The App Store requires sandboxing, which gets in the way of watching folders, opening any path you give it and the Claude Code hook. Download the app from the Download page instead; store editions are planned separately.

#Where do I report a bug or ask for a feature?

Open an issue on GitHub, or ask on Discord.