A beautiful way to read Markdown
villar re-renders AI-generated Markdown into a card-based reading experience. Focus on content, not clutter.
villar re-renders AI-generated Markdown into a card-based reading experience. Focus on content, not clutter.
RESTful API with JSON responses. Versioned via URL path. Rate limited to 1000 req/min per key.
This document describes the API design for the backend services. All endpoints follow REST conventions and return JSON responses with consistent error formats.
/api/v1OAuth 2.0 with PKCE flow. Tokens stored in secure HTTP-only cookies. Refresh tokens rotate on each use.
The API uses OAuth 2.0 with the PKCE extension for public clients. All endpoints require a valid Bearer token in the Authorization header.
Sliding window algorithm. 1000 requests/min for standard, 5000 for premium. Retry-After header on 429.
Rate limiting uses a sliding window algorithm. Limits are applied per API key and tracked via Redis. When exceeded, the API returns 429 with a Retry-After header.
Consistent error shape: code, message, details. Machine-readable codes. Human-readable messages.
All errors follow a consistent JSON structure with machine-readable error codes and human-readable messages. Validation errors include field-level details.
villar transforms long Markdown documents into focused, navigable cards with smart summaries and syntax highlighting.
Documents split by H2 headings into navigable cards. Arrow keys to move between sections.
Each section gets a rule-based summary. Keywords, key points, and conclusions at a glance.
Dim inactive cards to concentrate on what you're reading. Adjustable opacity in settings.
Code blocks with syntax highlighting and one-click copy. Supports all major languages.
Flowcharts rendered as step UI or diagrams. Sequence and class diagrams supported.
File watcher detects external changes and reloads content instantly. Changed sections highlighted.
Open multiple files in tabs. Full-text search across all files with Cmd+K.
46 color themes, 15+ fonts, adjustable font scale, line height, and content width.
English, Japanese, Chinese (Traditional & Simplified), Korean, Arabic, Spanish, German, Malay, and Vietnamese.
Bold the first part of each word to guide your eyes faster. Research-backed scanning optimization.
A highlight bar follows your cursor to keep your place. Reduces line-skipping and improves focus.
Export any document as a clean, print-ready PDF with one click. Dark themes automatically convert to white.
From dark favorites like Dracula and Nord to light themes like GitHub Light and Solarized. Every element adapts.
Your source files are never modified. villar only reads and renders.
Zero network requests. Your documents stay on your machine, always.
When rendering fails, content is always shown. No blank screens, ever.
Free and open source. Download for your platform.
Or build from source on GitHub
macOS: Run xattr -cr /Applications/villar.app in Terminal if you see "app is damaged".
villar is free and always will be. If it helps your workflow, consider supporting development.