How to open an HTML file on a Mac

Your AI handed you a .html file. It's sitting in your Downloads folder. On a Mac there are four ways to open it, depending on what you want to do with it next. Pick by outcome.

Just want to see how it looks?

Double-click the file in Finder. macOS hands it to your default browser (Safari, Chrome, Firefox, Arc) and the page renders. This is the zero-effort path, and it works for any self-contained HTML.

If macOS opens it in TextEdit instead, that's because TextEdit is set as the default for .html on your machine (unusual but possible). Right-click the file, choose Open With → Safari or your browser, and check "Always Open With" if you want to make the change permanent.

Want to send it to a colleague?

This is where the native macOS path gets clunky. Slacking or emailing the file works, but the recipient gets a download prompt, has to save it locally, then double-click it. Most non-technical recipients give up.

Faster: drop the file onto the box below. Vela Docs renders it, gives you a share link, and your colleague opens the link in any browser without downloading anything.

Want to edit before sharing?

On a Mac you've got three real options:

• VS Code (free): standard for developers. Live Preview extension renders side by side. Heavy if you don't already code.
• Vela Docs (web, free, no install): click Edit mode, click any text in the rendered page, type. Save downloads back to clean .html.
• Sublime Text / BBEdit: classic Mac text editors. Render preview requires a separate browser window.

Want to present it like a slide deck?

If the file uses the slide-pattern markup (sections with class slide or page), open it in Vela Docs and switch to Present mode. Arrow keys navigate. Spacebar advances. Full-screen with ⌃⌘F in Safari / Chrome works as expected.

Common gotchas

• External fonts or CSS don't load. If the HTML references a CDN URL and your Mac is offline (or the CDN is down), styles will silently fall back. Vela Docs's preview shows the same fallback so you can spot it.
• "Are you sure you want to open this file?"macOS Gatekeeper sometimes warns for files downloaded from Slack / email. The file itself can't damage your system; the warning is about provenance. Trust the sender or use Vela Docs which sandboxes everything.
• The file opens but looks blank. The browser may have blocked scripts loaded fromfile:// URLs. Vela Docs renders on an https page, so script restrictions don't apply.

One short takeaway

For seeing the file: double-click. For sharing it cleanly with anyone: Vela Docs. Both work without an install.