Support

For VeloUtils for macOS.

Reporting a bug

Four things make a report actionable. Please include them if you can:

1. Your macOS version — Apple menu › About This Mac.
2. The VeloUtils version — VeloUtils › About VeloUtils.
3. What you did, what you expected, and what happened instead.
4. A small file that reproduces it, if the problem depends on the document. Send only a file you are happy to share — see the privacy policy for what the app itself does with your documents, which is nothing beyond reading them on your Mac.

Reporting a security issue

Send security reports to support@veloutils.app with SECURITY in the subject line. Please do not post the detail publicly until a fix has shipped. We will confirm receipt and tell you what we find.

Common questions

How do I save my edits?

You cannot, and that is deliberate for this version. VeloUtils opens and reads your files; it does not write back to them. The Markdown, JSON and Mermaid panes are editable so you can work on the text and see the result, but closing the window discards those edits. The one thing the app writes is the Mermaid tool's Export, which creates a new PNG or SVG at a location you pick.

To get your work out, use the Copy button in the JSON, CSV and Mermaid tools. The Markdown editor has no Copy button — select the text and press ⌘C.

Which files can VeloUtils open?

Markdown	.md, .markdown, .mdown, .mkd, .mkdn, .txt, .text
JSON	.json
CSV	.csv, .tsv
Mermaid	.mmd, .mermaid

Press ⌘O, use each tool's Open button, or drag a file onto the window.

Finder's Open With and open -a VeloUtils also work, and switch the sidebar to the matching tool. Those routes cover the types VeloUtils registers with macOS — Markdown, JSON, CSV, TSV, .mmd and .mermaid. Plain .txt files are not registered, so open those from inside the app.

Keyboard shortcuts

⌘O	Open a file in the active tool
⌘⌥P	Markdown and Mermaid: hide or show the source pane
⇧⌘F	JSON: switch the output to Format
⌘F	Open the find bar in the focused text editor
⌘G / ⇧⌘G	Markdown: next and previous match in the preview
⌘Z	Undo in any editor
⌘C	CSV: copy the selected rows as tab-separated text
Pinch or drag	Mermaid: zoom and pan the diagram

Is my data sent anywhere?

No. There is no account, no analytics and no server. The single exception is that the Markdown preview fetches a remote image if your own document references one, the same as a browser would. The privacy policy covers this in full.

Why does a Mermaid diagram stay on screen when my source is broken?

Because that is more useful than a blank pane. VeloUtils validates the source before it renders, so a half-finished edit leaves the last good diagram in place, dimmed, while an error names the line to fix.

Which macOS do I need?

macOS 26.0 (Tahoe) or later, on Apple silicon or Intel.

Known limits

These are real and we would rather you heard them here than found them:

• The app cannot save changes back to a file. See above.
• The CSV grid stays comfortable to about 10,000 rows. Parsing a larger file is fast, but filtering and sorting it is done on every redraw.
• The Markdown renderer is hand-written rather than a full CommonMark implementation. Setext headings, reference-style links and footnotes are not supported.
• The JSON tool holds the whole document in memory and revalidates all of it as you type. It is not built for very large payloads.
• Opening several files at once from Finder loads only the first one.
• A very large Mermaid diagram is bounded by what the Mermaid library itself can lay out.

Licences

VeloUtils' own code is MIT-licensed. The bundled Mermaid library folds in 79 open-source packages; the full notices ship inside the app under Help › Acknowledgements.