Preview All-in-One with QuickLook
Preview files from VS Code through the Windows QuickLook app.
中文文档：README.zh-CN.md
Highlights
- Press
Alt+` or use the editor-title button to preview the focused file.
- Works from Explorer, editor tabs, Search Results, Source Control, Git Diff and History, and the Command Palette.
- Uses your local QuickLook installation, including its installed format plugins.
- Resolves the correct Git version for working, staged, deleted, Diff, and History files.
Requirements
Quick start
- Install and start QuickLook.
- Select a file in Explorer or Source Control, or focus an open local or Git file.
- Press
Alt+` , click the Preview button, or run QuickLook: Preview with QuickLook.
If QuickLook is not detected, run QuickLook: Set QuickLook Executable Path.
Source Control versions
| Context |
Previewed version |
| Changes and Untracked |
Working copy |
| Staged Changes |
Git index |
| Deleted files |
Last version that still exists |
| Diff and History editors |
Currently focused side |
The context-clicked row wins when multiple SCM rows are selected. Git versions are copied to version-labelled temporary files and removed after ten minutes or when the extension stops.
Commands
| Command |
Purpose |
QuickLook: Preview with QuickLook |
Preview the selected or active file. |
QuickLook: Check QuickLook Installation |
Check path resolution and installation status. |
QuickLook: Set QuickLook Executable Path |
Detect, browse for, or enter QuickLook.exe. |
Settings
| Setting |
Default |
Purpose |
quicklook.executablePath |
QuickLook.exe |
Resolve QuickLook from PATH and common Installer/Scoop locations, or use an explicit custom path. |
quicklook.previewOptions |
[] |
Additional QuickLook options such as /pin or /top. |
quicklook.useExplorerClipboardFallback |
true |
Resolve Explorer keyboard selection through a temporary Copy Path operation, then restore the clipboard. |
QuickLook commonly supports text and code, images, PDF and Office documents, archives, fonts, media, mail, design assets, and other formats. Actual coverage depends on your QuickLook version and installed plugins; see the official supported-formats list.
Tip (Markdown Preview): This extension focuses on lightweight, pop-up previews via Windows QuickLook for local files and Git history snapshots. For in-editor rendered preview and side-by-side editing, use VS Code's native Markdown preview (VS Code 1.120+ natively introduced rendered Markdown previews in Source Control / Diff editors; VS Code 1.120+ / latest 1.133+ is recommended for the full native experience).
Troubleshooting
- Run
QuickLook: Check QuickLook Installation.
- Correct the executable path if needed.
- Open the
QuickLook output channel for launch details.
- Confirm that QuickLook itself can preview the same file outside VS Code.
For support, see the support guide.
Development and release
Run npm test to compile and test. See the release guide for packaging and publishing.
License
GNU Affero General Public License v3.0 only
