Skip to content

Releases: ravindusp/PeekMD

PeekMD v1.0.3 - Embedded KaTeX Vector Fonts

Choose a tag to compare

@ravindusp ravindusp released this 16 Aug 03:03

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

  1. Download PeekMD-v1.0.3.dmg below.
  2. Open the DMG and drag PeekMD into your Applications folder.
  3. Launch PeekMD once from Applications.

πŸ”’ Checksum (SHA-256)

7eb3fb8830948ffc2d5597336058266fc8273227d1f9067331607051668e4024 PeekMD-v1.0.3.dmg

PeekMD v1.0.2 - Bundled Offline KaTeX Math Rendering

Choose a tag to compare

@ravindusp ravindusp released this 16 Aug 02:50

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

  1. Download PeekMD-v1.0.2.dmg below.
  2. Open the DMG and drag PeekMD into your Applications folder.
  3. Launch PeekMD once from Applications.

πŸ”’ Checksum (SHA-256)

651d121dd3cc03b12e8f60c0f5c1d605d604720731e67f19b4fd27d58f1efaaa PeekMD-v1.0.2.dmg

PeekMD v1.0.1 - LaTeX Math Rendering Fixes

Choose a tag to compare

@ravindusp ravindusp released this 16 Aug 02:42

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

  1. Download PeekMD-v1.0.1.dmg below.
  2. Open the DMG and drag PeekMD into your Applications folder.
  3. Launch PeekMD once from Applications.

πŸ”’ Checksum (SHA-256)

a753d8c072796de4d1b1de57d82dd41c1284a5fdc209a1461e222242b4771742 PeekMD-v1.0.1.dmg

PeekMD v1.0.0 - Markdown where it belongs

Choose a tag to compare

@ravindusp ravindusp released this 16 Aug 00:39

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 .md files 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

  1. Download PeekMD-v1.0.0.dmg below.
  2. Open the DMG and drag PeekMD into your Applications folder.
  3. Launch PeekMD once from Applications.
  4. (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

Choose a tag to compare

@ravindusp ravindusp released this 15 Aug 19:25

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-gfm AST 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>, and on* 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-word and max-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

  1. Download PeekMD-v0.2.dmg.
  2. Open the disk image and drag PeekMD into Applications.
  3. Launch PeekMD to enable instant Spacebar Quick Look previews and Finder right-click Markdown creation.

PeekMD v0.1.0

Choose a tag to compare

@ravindusp ravindusp released this 15 Aug 18:13

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 .md file.
  • πŸ›‘οΈ 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

  1. Download PeekMD-v0.1.dmg.
  2. Open the disk image and drag PeekMD into Applications.
  3. Launch PeekMD and follow the 3-step setup guide to enable the Finder Sync Extension in macOS System Settings.

PeekMD v0.3 (Beta)

PeekMD v0.3 (Beta) Pre-release
Pre-release

Choose a tag to compare

@ravindusp ravindusp released this 15 Aug 23:32

✨ 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.quarantine from its embedded .appex plugins 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

  1. Enable PeekMD Extension under System Settings β†’ General β†’ Login Items & Extensions β†’ Finder Extensions.
  2. Click Relaunch Finder inside PeekMD (or run killall Finder in Terminal).
  3. If macOS restricts downloaded extensions, run:
    xattr -cr /Applications/PeekMD.app && killall Finder

πŸ“₯ Verification

  • DMG: PeekMD-v0.3.dmg
  • SHA256: 213146d94ed3f2858a1150c7df8cfb944147b056051c02373f96e07c7c9a64f5