Markdown comments
Comments that stay with the Markdown file.
Imark lets you select a phrase and add a margin comment. The note is saved inside the .md file as an HTML comment, so it travels through email, Git, and file copies without appearing in other Markdown viewers.
macOS 14+ · 5.8 MB
Updated
How Markdown annotation works
The document remains ordinary Markdown. Imark adds a small, structured HTML comment next to the text you annotated.
Select a phrase
Anchor the note to the exact words you want to discuss.
Write in the margin
Add the question, correction, or decision beside the rendered document.
Keep it with the file
The comment is saved inside the Markdown and follows every normal file workflow.
Invisible in other renderers
GitHub, Obsidian, code editors, and standard Markdown renderers ignore HTML comments. The annotation remains available in the raw file and reappears when the document opens in Imark.
Useful for Git and local-first work
Because annotations are part of the document, they can be reviewed in a diff, committed with a plan, moved between branches, or sent to another person without creating a separate database or account.
A review record that does not disappear
Resolved comments stay in the file as a record of what was requested. Imark fades resolved notes instead of deleting them, which keeps decisions traceable without cluttering the active review round.
Questions
What people want to know.
Do Imark comments appear on GitHub?
No. GitHub does not render HTML comments, so the page shows the original Markdown while the note remains in the source file.
Do comments require an account?
No. Comments are local file content. There is no account, cloud workspace, or separate annotation database.
Can an AI coding agent read the comments?
Yes. Imark includes an agent workflow that extracts the structured comments so Codex or Claude Code can respond to each requested change.
Keep exploring Imark
Agent skill for Markdown review
Imark Skill for Claude Code and Codex
Review Markdown plans with Claude Code or Codex. The Imark skill opens a blocking Mac review, returns anchored comments, and keeps decisions in the file.
Read the guideOpen .md files on Mac
How to Open Markdown Files on Mac
Open .md files on Mac as rendered documents. Compare TextEdit, editor previews, Quick Look, and a dedicated Markdown viewer such as Imark.
Read the guideRead Markdown like a document.
Download Imark for a focused Markdown viewer built for Mac, Finder, and local files.
Download for macOS