English version by Peter Wone
Chinese Version by Kuriyamasss,中文版本由Kuriyamasss翻译
Most failure on first use is due to faulty repackaging by a third party. If this happens to you, obtain the package produced and tested by us.
Custom Markdown styling is back! See the manual for details of how to use your own CSS files with Markdown rendering.
We have community translations into Spanish and Chinese.
Markdown and source code, styled for print
Source code gets line numbers and syntax colouring. Markdown is rendered with VS Code's preview rendering pipeline — many Markdown extensions work with printing.
Platform independent printing
Print-jobs are rendered as styled HTML and served from an embedded webserver. When you print, your local web browser is launched to load the print-job and give you printing options like page orientation and margin size. So if you have a local browser that can print, and VS Code can launch it, you're in business. Known user platforms include Windows, Linux and OSX.
Troubleshooting on first launch
Print worked for fifty thousand people out of the box, but sometimes local settings and permissions can spoil the fun. Here are some problems people have encountered, and what to do. If something else is wrong, or you have an improvement idea, we invite you to log an issue on the GitHub repository.
Classic user experience
The print icon on the toolbar prints the document in the active editor.
If you have a text selection that crosses at least one line-break you can right click and choose
Or you can right-click on a file in the file explorer pane and choose Print from the context menu.
Printing on Mac, Linux and Windows
This software is tested only with the version of Visual Studio Code published by Microsoft. Other variants such as code-oss have been known to botch the installation of resources, leading to runtime errors.
Testing is done on Windows 10 and Ubuntu with current builds of Chrome, Edge and Firefox.
Testing does not include OSX. If you feel that Macs shouldn't be second class citizens then there are three options.
Testing does not include Windows XP, 7 or 8 but detailed bug reports relating to these platforms will be taken seriously.
Raise an issue on the repository.
For issues pertaining to rendered Markdown, attach a test document demonstrating the problem. Include supporting images and stylesheets. Use a zip file for samples that require a directory structure.
Screen snaps of failed outcomes are always a good idea.
The Print extension is highly configurable. Settings can be modified by going to Code > Preferences > Settings > Extensions > Printing.
A detailed breakdown of these settings can be found in the manual.
Choice of browser
The browser used will affect your experience.
Recommended for printing
Any Chromium derived browser should be fine. The following are known to work well.
Not recommended for printing
Non-standard variants of VS Code such as code-oss may fail to install dependencies resulting in errors about not being able to find CSS files. See https://github.com/PeterWone/vsc-print/issues/116 for details and remedial instructions.
Markdown extensions and remoting
To use Print with a remote host you must install it on the remote host.
To get the benefit of a Markdown extension when printing a document from a remote host, the Markdown extension must be built with an
Spaces in paths
On Windows you cannot supply command-line options on the alternate browser path because we automatically put quotes around your path in case of spaces in file or folder names.
On other platforms auto-quoting is not done and you must manually escape spaces in file and folder names.
Work around auto-quoting by creating a batch file in the same directory as the browser executable and use this to specify the options you require. For the browser path, supply the path to the batch file. Don't forget to pass through the URL parameter.
Chrome and plugins
Chrome may retain your printer, paper size and margin selections between print jobs. Some Chrome command line options cause errors to be reported, even though printing succeeds.
Some Chrome plugins interfere with print job styling. While it is possible to suppress plugins with
For better results burn some disk space and install another browser such as Chromium, and use this for printing. You may be able to achieve a similar result without needing two browsers by using profiles on Edge.
Indirect Internet dependencies
The Math+Markdown extension (installs the KaTeX plugin) requires an internet connection for stylesheets and fonts. You must also configure a stylesheet reference. Details are in the manual.
Refer to the changelog for a complete history.