Markdown Easy Read
A VS Code extension that provides a reader-optimized markdown preview with zoom controls and responsive layout.
Features
- Reader-Optimized Preview: Comfortable typography with optimized padding, margins, and line spacing
- Zoom Controls: Adjust font size with keyboard shortcuts or UI buttons
- Persistent Preferences: Zoom level persists across VS Code sessions
- Theme Integration: Automatically adapts to VS Code's light/dark theme
- Live Updates: Preview updates in real-time as you edit (200ms debounce)
- Responsive Layout: Adapts to narrow and wide panel widths
- Smart Content Handling: Text wraps, tables scroll horizontally
- Image Support: Displays images with graceful error handling
Usage
Opening Preview
- Open any markdown file (
.md)
- Open Command Palette (
Ctrl+Shift+P / Cmd+Shift+P)
- Run command: "Open Markdown Easy Read"
Or right-click on a markdown file and select "Open With → Markdown Easy Read"
Zoom Controls
Keyboard Shortcuts
- Zoom In:
Ctrl/Cmd +
- Zoom Out:
Ctrl/Cmd -
- Reset Zoom:
Ctrl/Cmd 0
Look for + and − buttons in the top-right corner of the preview.
Theme Switching
The preview automatically adapts when you change VS Code themes:
- Go to Settings → Color Theme
- Select any light or dark theme
- Preview updates instantly
Requirements
Extension Settings
This extension stores:
markdownEasyRead.zoomLevel: Global zoom preference (0.5-3.0, default: 1.0)
Known Issues
- Custom CSS in markdown is not supported
- Some advanced markdown features may render differently than GitHub
Release Notes
See CHANGELOG.md for detailed release notes.
1.0.0
Initial release with core features:
- Reader-optimized markdown preview
- Zoom controls (keyboard + UI)
- Theme integration
- Live updates
- Responsive layout
Contributing
This extension was built using the Specify workflow. For contributions:
- See design specifications in
specs/001-i-want-to/
- Follow TDD approach (tests first)
- Maintain responsive design patterns
License
MIT
Enjoy reading markdown! 📖# MarkDownEasyRead
| |
