Help & Support

Common questions, troubleshooting, and how to reach us.

Quick fixes

CLI won't connect

Check your internet connection
Run mding-cli ping to test server connectivity
Run mding-cli auth status to verify you're authenticated
If your token expired, run mding-cli auth login to re-authenticate

troubleshooting

  $ mding-cli ping ✓ ok     Server reachable (42ms)   $ mding-cli auth status  Auth:   Authenticated  Server: https://app.markdown.ing  

Files not syncing

Make sure the file has a .md extension
Check that the file is under 10 MB
Verify the file is inside the watched directory (symlinks to outside paths are rejected)
Try --verbose to see detailed sync events: npx mding-cli --verbose

Browser doesn't open automatically

Some environments (SSH, containers, headless servers) can't launch a browser. Use --no-browser and open app.markdown.ing manually:

$ npx mding-cli --no-browser

Session stuck or disconnected badly

If a previous session didn't disconnect cleanly (e.g., you closed the terminal), use the disconnect command from another terminal:

$ mding-cli disconnect ✓ ok Disconnected

Export taking too long

Exports with many diagrams may take longer because each diagram is pre-rendered server-side. If an export seems stuck, check back in a minute — the job queue processes exports sequentially.

FAQ

Are my files stored on your servers?

No. Files are transmitted over the WebSocket only while the CLI is running. When you disconnect, nothing remains server-side. The server sees file content transiently to render the preview — it doesn't persist it.

Does it work over SSH?

Yes. Run npx mding-cli on any machine you can SSH into. The web editor connects to that remote session. No port forwarding or X11 needed — the CLI talks to markdown.ing's servers, and your browser talks to the same servers. They meet in the middle.

What Node.js version do I need?

Node.js 18 or later. The CLI uses ES modules and modern Node APIs.

Can I use a self-hosted server?

The --server flag lets you point at any compatible server. Self-hosting documentation is not yet available, but the flag exists for when it is.

Is there a desktop app?

Not yet. The web editor works well on desktop browsers and the CLI handles the local file sync. A desktop app may come later, but the current workflow — CLI + browser — is the intended experience.

What markdown features are supported?

CommonMark plus: tables, task lists, footnotes, strikethrough, fenced code blocks with syntax highlighting, and diagram blocks (Mermaid, D2). The cheatsheet overlay in the editor covers all supported syntax.

How do I cancel my account?

Everything is free during testing, so there's nothing to cancel. When paid tiers launch, you'll be able to manage your subscription from your account settings.

Get in touch

Found a bug or have a feature request? Email hello@markdown.ing.