Releases: ravindusp/PeekMD
Release list
PeekMD v1.0.3 - Embedded KaTeX Vector Fonts
What's New in v1.0.3
This release embeds the complete collection of official KaTeX TeX vector fonts directly into the renderer binary.
β¨ What's Fixed
- Pixel-Perfect Math Accents: Fixed overlapping and misaligned accents (
\hat y,\hat r,\vec v,\tilde x,\bar x, etc.) by bundling the authentic TeX font metrics directly into the offline renderer stylesheet. - Embedded WOFF2 Font Suite: Embedded all 20 official KaTeX WOFF2 font files (
KaTeX_Main,KaTeX_Math,KaTeX_AMS,KaTeX_Caligraphic,KaTeX_Size1-4, etc.) as self-contained base64 data URIs. - 100% Offline Quick Look Typography: Guarantees authentic, publication-quality LaTeX typography across both Quick Look previews and the standalone Markdown reader without network calls.
π¦ Installation
- Download
PeekMD-v1.0.3.dmgbelow. - Open the DMG and drag PeekMD into your Applications folder.
- Launch PeekMD once from Applications.
π Checksum (SHA-256)
7eb3fb8830948ffc2d5597336058266fc8273227d1f9067331607051668e4024 PeekMD-v1.0.3.dmg
PeekMD v1.0.2 - Bundled Offline KaTeX Math Rendering
What's New in v1.0.2
This release bundles the complete KaTeX mathematical typesetting engine (CSS, JS, and Auto-Render extension) directly into PeekMD.
β¨ What's Fixed
- Full LaTeX Typesetting: Equations like
\[\hat y=p+\hat r\], fractions, exponents, Greek symbols, matrices, and accents now render with full mathematical typesetting instead of displaying raw LaTeX commands in the preview. - 100% Offline Quick Look: Because KaTeX is embedded directly in the renderer binary, mathematical typesetting works immediately in macOS Quick Look previews without requiring network access or external CDNs.
- Zero-Delay Rendering: Formulas render instantaneously on document load across both Quick Look and the standalone Markdown reader.
π¦ Installation
- Download
PeekMD-v1.0.2.dmgbelow. - Open the DMG and drag PeekMD into your Applications folder.
- Launch PeekMD once from Applications.
π Checksum (SHA-256)
651d121dd3cc03b12e8f60c0f5c1d605d604720731e67f19b4fd27d58f1efaaa PeekMD-v1.0.2.dmg
PeekMD v1.0.1 - LaTeX Math Rendering Fixes
What's New in v1.0.1
This patch release fixes LaTeX mathematical typesetting when using LaTeX display bracket delimiters \[ ... \] and expands math formatting capabilities across Quick Look and the standalone reader.
π Bug Fixes & Improvements
- LaTeX Display Bracket Math (
\[ ... \]): Fixed an issue where\[ ... \]display equations were stripped of backslashes by the CommonMark parser and rendered as plain text[ \text{...} ]. - Expanded LaTeX Environment Support: Added native handling for LaTeX environments such as
\begin{align}...\end{align},\begin{equation}...\end{equation},\begin{cases}...\end{cases},\begin{gather}...\end{gather}, etc. - Single-Line Math Blocks: Fixed support for single-line
$$ ... $$and\[ ... \]expressions. - Inline LaTeX Math (
\( ... \)): Protected inline parentheses math from CommonMark escape stripping and markdown underscore italicization (_). - Code Block Protection: Ensured math-like tokens inside code blocks and inline code spans are preserved without modification.
π¦ Installation
- Download
PeekMD-v1.0.1.dmgbelow. - Open the DMG and drag PeekMD into your Applications folder.
- Launch PeekMD once from Applications.
π Checksum (SHA-256)
a753d8c072796de4d1b1de57d82dd41c1284a5fdc209a1461e222242b4771742 PeekMD-v1.0.1.dmg
PeekMD v1.0.0 - Markdown where it belongs
What's New in v1.0.0
Markdown where it belongs β right in Finder.
PeekMD brings native, lightweight Markdown superpowers to macOS without vaults, workspaces, or heavyweight editors.
β¨ Key Features
- Finder-Native File Creation: Right-click the background of any Finder window to create new
.mdfiles instantly. - Instant Quick Look Previews: Select any Markdown file and hit Spacebar for rich previews with syntax highlighting, tables, callouts, and math.
- Standalone Reader / Editor: Fast and clean viewer with themes (System, GitHub Light/Dark, Dracula, Monokai, Nord, Solarized).
- Universal Binary: Native support for Apple Silicon (M1βM4) and Intel Macs.
- Zero Permission Prompts: Clean App Sandbox and Team ID container architecture.
π¦ Installation
- Download
PeekMD-v1.0.0.dmgbelow. - Open the DMG and drag PeekMD into your Applications folder.
- Launch PeekMD once from Applications.
- (If opening for the first time on a new Mac) Right-click PeekMD.app in Applications and choose Open.
π Checksum (SHA-256)
fe2459f656d9f14f1eb7a84339aa2c6c793ee52a0092633396003315ec71d5a2 PeekMD-v1.0.0.dmg
PeekMD v0.2
PeekMD v0.2 - Next-Generation AST Markdown Engine π
PeekMD v0.2 introduces a completely overhauled Markdown parser and rendering architecture powered by Apple's official swift-markdown (backed by cmark-gfm), bringing full GitHub-Flavored Markdown compliance, safe raw HTML rendering, token-based syntax highlighting, local LaTeX math typesetting, and enhanced Obsidian callout support to both macOS Quick Look and the standalone PeekMD viewer.
β¨ What's New in v0.2
π§ Full AST Markdown Parser (swift-markdown)
- Replaced the line-oriented regex parser with Apple's official
swift-markdown/cmark-gfmAST parser. - Reliable CommonMark & GitHub-Flavored Markdown parsing with accurate AST node traversal.
- Proper nested list hierarchies, multiline list items with continuation paragraphs, code blocks, and blockquotes.
- ATX (
# H1..###### H6) and Setext (===,---) headings with auto-generated anchor IDs for document navigation. - GFM table alignments (
:---,:---:,---:) with escaped pipe\|support and horizontal scroll wrappers.
π‘οΈ Safe Raw HTML & GitHub README Compatibility
- Full support for standard GitHub README HTML markup:
<div align="center">,<img width="420">,<details>,<summary>,<kbd>,<mark>,<sub>,<sup>, and raw tables. - Built-in HTML sanitization that automatically rejects
<script>,<iframe>,<object>, andon*event handlers. - HTML comments are automatically hidden/stripped from visible output.
π¨ Single-Pass Tokenized Syntax Highlighting
- Fixed regex corruption over generated HTML tags by introducing a single-pass, token-based syntax scanner.
- Source code is tokenized into non-overlapping intervals (
keyword,string,comment,number,type,function,property,tag) and escaped exactly once. - Zero
class="token-string">text pollution across Swift, TypeScript/JS, JSON, Bash, HTML, C/C++, Rust, Go, Python, SQL, and CSS.
πΌοΈ Robust Local Image & Asset Resolution
- Directory-aware relative path lookup for sibling assets (
assets/logo.png), parent paths (../images/img.png), and percent-encoded paths. - Local images are automatically embedded as Base64
data:<mime>;base64,...data URIs, enabling sandbox-safe rendering in both Quick Look previews and WebKit views.
π Local LaTeX / Math Typesetting
- Bundled local KaTeX stylesheets and auto-render engine with zero external CDN dependencies.
- Inline math (
$E = mc^2$) and display math blocks ($$\int_{-\infty}^{\infty} e^{-x^2}\,dx = \sqrt{\pi}$$). - Currency values (
$50 and $100) are protected from accidental math conversion.
π Obsidian Callouts & Wikilinks
- 13 Obsidian callout styles:
NOTE,TIP,IMPORTANT,WARNING,CAUTION,INFO,SUCCESS,QUESTION,FAILURE,DANGER,BUG,EXAMPLE,QUOTE. - Native foldable callout support:
> [!NOTE]+(expanded by default) and> [!NOTE]-(collapsed by default) using semantic HTML5<details>and<summary>. - Wikilink support:
[[Target]],[[Target|Alias]],[[Target#Section]],[[Target#^block]], and image embeds![[assets/image.png|300]].
π± Layout Overflow Protection
- Universal
overflow-wrap: break-wordandmax-width: 100%across all 4 themes (System, GitHub, Minimal, Academic) preventing document-wide horizontal scrollbars. - Responsive table containers with dedicated horizontal scrolling.
π¦ Release Assets & Checksums
| File | SHA-256 Checksum |
|---|---|
PeekMD-v0.2.dmg |
628a2b23ad837a254003ef6166a924842c6eb05ded9c3c25be4d4f5f18ef15a4 |
π οΈ Installation
- Download PeekMD-v0.2.dmg.
- Open the disk image and drag PeekMD into Applications.
- Launch PeekMD to enable instant Spacebar Quick Look previews and Finder right-click Markdown creation.
PeekMD v0.1.0
PeekMD v0.1.0 - Markdown, anywhere. π
PeekMD brings the missing "Create New Markdown File" action to Finder's blank-background context menu and turns macOS Quick Look (Spacebar) into an instant, rich Markdown previewer.
β¨ What's New in v0.1.0
- π Finder Right-Click Creation: Right-click any empty folder background in macOS Finder to immediately create a new
.mdfile. - π‘οΈ Collision-Safe: Never overwrites existing documents (
Untitled.md,Untitled 2.md, ...). - π Instant Quick Look Preview: Tap Spacebar in Finder for formatted preview with zero startup lag.
- π GitHub Flavored & Obsidian Markdown:
- GFM Tables with alignments
- Task lists / Checkboxes (
- [ ],- [x]) - Fenced code blocks with language badges & syntax highlighting
- Obsidian-style Callouts (
[!NOTE],[!TIP],[!WARNING],[!IMPORTANT],[!CAUTION]) - LaTeX / Math expressions (
$...$,$$...$$) - YAML frontmatter presentation
- πΌοΈ Local Asset Resolution: Automatically renders relative local images (
images/diagram.png). - π¨ Adaptive Themes: Apple San Francisco typography with Light/Dark mode and multiple style themes (System, GitHub, Minimal, Academic).
- π₯οΈ Integrated Standalone Viewer & Editor: Live word & line counters, reading time estimates, and one-click external editor launching.
- πΏ Stylized DMG Installer: Custom installer background with direct drag-and-drop to Applications (
PeekMD.app).
π¦ Release Assets & Checksums
| File | SHA-256 Checksum |
|---|---|
PeekMD-v0.1.dmg |
15bdcf6de3c0e281aa1b4d4d13e324244c1aea33dc57ce11ae7c9c329c57837e |
π οΈ Installation
- Download PeekMD-v0.1.dmg.
- Open the disk image and drag PeekMD into Applications.
- Launch PeekMD and follow the 3-step setup guide to enable the Finder Sync Extension in macOS System Settings.
PeekMD v0.3 (Beta)
β¨ What's New in PeekMD v0.3 (Beta)
π οΈ Self-Healing Extension Registration & Finder Controls
- Automatic Quarantine Removal: When launched, PeekMD now automatically clears
com.apple.quarantinefrom its embedded.appexplugins so macOS Finder can safely load them without Gatekeeper blocking. - Relaunch Finder Action: Added one-click "Relaunch Finder" and "Repair Extension" buttons in both the Quick Setup Guide and Settings & Preferences window to immediately reload Finder's extension host.
- Expanded Directory Monitoring: Full support for iCloud Drive (
~/Library/Mobile Documents/com~apple~CloudDocs), synced Desktop/Documents folders, and custom monitored directory structures.
π¦ Quick Troubleshooting for Finder Context Menu
- Enable PeekMD Extension under System Settings β General β Login Items & Extensions β Finder Extensions.
- Click Relaunch Finder inside PeekMD (or run
killall Finderin Terminal). - If macOS restricts downloaded extensions, run:
xattr -cr /Applications/PeekMD.app && killall Finder
π₯ Verification
- DMG:
PeekMD-v0.3.dmg - SHA256:
213146d94ed3f2858a1150c7df8cfb944147b056051c02373f96e07c7c9a64f5