Skip to content

Add MacMD Viewer to tools directory - #271

Open
Crackx17 wants to merge 4 commits into
mattcone:masterfrom
Crackx17:add-macmd-viewer
Open

Add MacMD Viewer to tools directory#271
Crackx17 wants to merge 4 commits into
mattcone:masterfrom
Crackx17:add-macmd-viewer

Conversation

@Crackx17

@Crackx17 Crackx17 commented Mar 28, 2026

Copy link
Copy Markdown

Adding MacMD Viewer, a native macOS Markdown viewer with Mermaid diagram support and a Quick Look extension. Modeled the tool file after existing entries like Marked 2.

MacMD Viewer is a read-only Markdown viewer for macOS (SwiftUI) with:

  • Mermaid diagram rendering, including inside Finder previews
  • A Quick Look extension — press Space on any .md file in Finder
  • Syntax highlighting in fenced code blocks
  • Document outline sidebar with scroll spy
  • Live reload when a file changes on disk
  • 12 document themes, light and dark

Requires macOS 14 or later. Universal binary (Apple Silicon and Intel).

Website: https://macmdviewer.com
Price: $19.99 one-time, no subscription

Crackx17 and others added 3 commits March 28, 2026 14:47
- Add the missing 200x200 tool icon (entry referenced an icon that
  was never committed, so it rendered broken)
- Drop the inflated '190+ languages' claim (ships the highlight.js
  common subset)
- Mark heading IDs as partial: auto-generated, no custom IDs
- Tone down the description per the directory's minimal-marketing guideline
Custom heading IDs are supported: both the trailing `{#custom-id}` form on a
heading and a standalone `{#custom-id}` anchor paragraph. The entry was written
before that shipped and still declared it unsupported.
@Crackx17

Crackx17 commented Aug 1, 2026

Copy link
Copy Markdown
Author

Hi Matt — following up on this one, no urgency.

I've just pushed a correction. The entry declared partial support for heading IDs, with a note saying custom IDs weren't possible. That's no longer accurate — MacMD Viewer supports both a trailing {#custom-id} on a heading and a standalone {#custom-id} anchor paragraph — so the row is now y, with a note describing both forms. I re-checked the task-list row against the current release at the same time; it's correct as declared.

The branch is mergeable against master. Happy to rebase, trim the description, or revise any of the syntax flags if you'd categorise something differently.

Is there anything blocking it on your side?

Adds the Quick Look preview screenshot, matching the format of the other
tool pages, and expands the description. Also links to the Marked 2 entry,
since the two apps solve the same problem in different places.
@Crackx17

Crackx17 commented Aug 8, 2026

Copy link
Copy Markdown
Author

Hi Matt — I've updated this rather than just bump it again.

The entry was missing a screenshot, which every other tool page has, so I've added the Quick Look preview. I also expanded the description and linked across to the Marked 2 entry, since the two apps solve the same problem in different places and a reader landing on one probably wants to know about the other.

The syntax table is unchanged and still accurate against the current release. Deploy preview builds clean, and the page renders here: https://deploy-preview-271--markdown-guide.netlify.app/tools/macmd-viewer/

If the tools directory is still taking additions and anything here needs changing — shorter description, different category, a syntax flag you'd categorise differently — tell me and I'll fix it the same day. If it isn't taking additions, that's a perfectly good answer too and I'll leave it be.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant