Free tool · works now
Markdown Diff Viewer
Compare two versions of a Markdown note side by side with line-by-line and word-level change highlighting.
Runs 100% in your browser. Compare original and modified Markdown notes, inspect word-level revisions, and export unified patches with complete client-side privacy.
| 1 | 1 | # Product Architecture Review | |
| 2 | 2 | ||
| 3 | - | Date: 2026-10-08 | |
| 4 | 3 | ~ | Status: Draft Date: 2026-10-12 |
| 4 | + | Status: Approved | |
| 5 | 5 | ||
| 6 | 6 | ## 1. Executive Summary | |
| 7 | 7 | ~ | We are evaluating local transcription models for macOS. Cloud transcription is currently used for audio processing. We are evaluating local transcription models for macOS. All transcription must run strictly on-device using Apple Neural Engine. |
| 8 | 8 | ||
| 9 | 9 | ## 2. Audio Pipeline Requirements | |
| 10 | 10 | - Capture system audio via ScreenCaptureKit | |
| 11 | 11 | - Resample audio buffers at 16kHz mono | |
| 12 | 12 | ~ | - Store audio on central cloud server - Store audio locally in user's Markdown vault (zero cloud storage) |
| 13 | 13 | ||
| 14 | 14 | ## 3. Decisions & Action Items | |
| 15 | - | - Decision: Test Whisper small model on CPU. | |
| 16 | - | - Action: Alex to benchmark cloud latency by Friday. | |
| 17 | 15 | ~ | - Action: Jordan to research third-party transcription vendors. - Decision: Adopt CoreML Whisper Large v3 Turbo on Apple Silicon. |
| 16 | + | - Action: Alex to verify ANE quantization accuracy by 2026-10-16. | |
| 17 | + | - Action: Jordan to remove all third-party cloud SDKs. | |
| 18 | + | - Action: Morgan to verify lock-free ring buffer performance. | |
| 18 | 19 | ||
| 19 | 20 | ## 4. Open Questions | |
| 20 | 21 | ~ | ? Can we reduce cloud hosting costs? ? What is the peak memory footprint during 60-minute calls? |
| 21 | 22 |
Why text-aware diffing is essential for Markdown note-takers
In knowledge management, software architecture, and team decision-making, notes are living documents. A product requirements document evolves across multiple review cycles; an architectural decision record reflects shifting technical constraints; and meeting minutes undergo revisions to ensure accurate task assignments.
However, understanding what actually changed between two versions of a Markdown note can be frustrating. Standard command-line diff tools (diff or git diff) are designed primarily for programming source code where each statement occupies a single line. When applied to long-form prose or Markdown notes with multi-line paragraphs, traditional diff tools flag entire paragraphs as deleted and re-added even when only a single word or timestamp was adjusted. This browser tool solves that friction with instant visual, word-level change highlighting.
Line-by-line diffing versus word-level granularity for prose
Prose editing requires a two-tiered diffing approach:
- Structural line alignment: Longest Common Subsequence (LCS) algorithms determine which sections, headings, list items, and blockquotes remained identical, which were moved or removed, and which are completely new.
- Intra-line word highlighting: When a line is edited—such as updating an action item owner from "Jordan" to "Alex" or amending a completion date—the engine pairs the old and new lines, computes sub-line token differences, and renders precise red and green chips. You immediately see the exact words that changed without rereading the whole paragraph.
Resolving git merge conflicts and accidental vault overwrites
Local-first note-taking applications save files directly to disk, often backed by Git repositories, iCloud Drive, Syncthing, or Dropbox. While local storage provides unparalleled data sovereignty, background synchronization can occasionally create conflicting copies (e.g. note (conflicted copy).md or standard Git merge conflict markers).
Before resolving a conflict or accepting an automated merge, authors need to review discrepancies side by side. By pasting both file versions into this tool, you can verify which edits occurred in which copy, ensure no critical meeting action items are lost, and export a unified patch or copy the clean merged text. Check out our Obsidian vault guide for best practices on vault backup and conflict prevention.
Privacy implications of comparing confidential drafts online
Many popular web-based "text diff" services send pasted text to third-party cloud servers for rendering or analytics. When comparing sensitive meeting minutes, executive compensation reviews, legal drafts, or patented architectural designs, pasting text into public web tools creates immediate confidentiality risks.
This utility executes 100% in your local browser tab using zero external network requests. Your document text, revisions, and diff summaries never touch an external server, preserving strict confidential privilege. You can safely compare sensitive documents on an air-gapped machine or without internet access.
Native revision tracking and meeting records in Oyma
At Oyma, we believe you should never have to guess what transpired during team discussions. Our macOS application captures meeting audio locally without intrusive bots, linking audio timestamps directly to your Markdown notes. Explore our other free utilities, including the Markdown table of contents builder and Markdown word counter, or read our Obsidian comparison to see how Oyma elevates local Markdown workflows.
Questions
How does this Markdown diff tool compare documents?
The engine uses a deterministic Longest Common Subsequence (LCS) algorithm to align lines between original and modified documents. When adjacent lines differ, it performs sub-line tokenization to highlight specific words added, removed, or edited.
What is the difference between split view and unified view?
Split view places original and modified documents side by side in dual columns with synchronized line numbering. Unified view presents all revisions sequentially in a single inline stream, using red (-) and green (+) background highlights.
How does word-level sub-diffing work on modified lines?
Standard diff tools flag entire paragraphs as changed when even a single typo is fixed. Our engine breaks modified lines into discrete words and punctuation tokens, highlighting exact word substitutions with color-coded token chips.
Can I export the comparison as a standard git patch?
Yes. The tool generates a standard unified diff patch (diff -u format) that you can copy to your clipboard and apply using git apply, patch, or review in code review tools.
Does this tool transmit my confidential notes or drafts to external servers?
No. The entire comparison engine runs 100% locally in your web browser. No document text, diff outputs, or file metadata are ever transmitted, logged, or uploaded over the internet.
Want notes that track decisions without cloud leaks?
Complete Obsidian vault compatibility, on-device Whisper transcription, and zero meeting bots in Oyma.