Frequently Asked Questions
Everything you might wonder about markjason. If your question isn't here, it might be because the answer is "we won't add that."
The Basics
What file types does markjason support?
markjason supports .md (Markdown), .json (JSON), and .env (environment variable) files. That's it — no other formats.
This focus is intentional: do three things extremely well instead of everything poorly.
Is markjason free?
Yes, completely free. No subscription, no account required, no feature gates. Just download and use it.
Does markjason work on Windows or Linux?
No. markjason is a native macOS app built with SwiftUI. It requires macOS 14 (Sonoma) or later.
There are no plans for Windows or Linux versions — the native approach is what makes it so fast.
Performance
How fast is markjason compared to VS Code?
markjason launches in about 0.3 seconds and uses ~100MB RAM.
VS Code typically takes 2-5 seconds to launch and uses 500MB-1GB+ of RAM.
The difference: markjason is native Swift; VS Code is Electron (Chromium-based). See our detailed comparison.
Why is markjason so fast?
Native Swift + SwiftUI. No JavaScript runtime, no Chromium, no Electron. The app does exactly what it needs to and nothing more.
Features
Can markjason edit files or is it just a viewer?
Both. Toggle between read and edit mode instantly with ⌘E. Changes save automatically.
What is live file sync?
markjason watches files for external changes. When another program (like an AI coding agent) edits a file you have open, markjason updates the view instantly. No manual refresh needed.
This is killer for AI coding workflows where agents constantly modify your files.
How do I count tokens in a file?
Press ⇧⌘I to see token count. Useful when crafting prompts for AI models.
Can I share markdown as an image?
Yes. Press ⇧⌘C to copy the rendered markdown as an image. Great for sharing specs with non-technical colleagues.
Anti-Features
Does markjason have a light mode?
No. Dark mode only. This is a deliberate choice for a developer-focused tool.
We're not adding light mode. Seek help.
Why doesn't markjason have plugins?
Plugins add complexity, slow things down, and create maintenance burden. markjason is intentionally minimal.
If you need plugins, use VS Code or Obsidian — great tools for different purposes.
Will you add Git integration?
No. That's what git is for. markjason stays focused.
What about cloud sync?
No built-in sync. Your files live on your computer. Use git, iCloud, Dropbox, or whatever you prefer.
AI & Coding Workflows
Can I use markjason with Claude Code, Cursor, or Codex?
Yes! markjason was built specifically for AI coding workflows.
Its live file sync means you see agent edits in real-time, and the instant launch means you can quickly check configs and prompts without waiting for a heavy IDE to load.
What's an AGENTS.md file?
AGENTS.md is a convention for defining AI agent behavior in a project. It's a markdown file that tells coding agents how to work with your codebase. markjason makes editing these files fast and pleasant.
Privacy
Does markjason track me or collect data?
No. Zero analytics, zero tracking, zero telemetry. We literally don't know you exist. Your files stay on your machine.
Do I need to create an account?
No. There's no account, no login, no sign-up. Download, open, use.