It is not a preview package, because what you see is the final, high-quality PDF output.
Activated by keyboard shortcut (default
Alt-P) or menu item, Pandoc/PDF inserts a toolbar into the active editor, processes the document with Pandoc, and shows the resulting PDF. By default, the document is reprocessed every time it is saved, but that can be deactivated and reprocessing triggered instead with the keyboard shortcut or a toolbar button.
Pandoc/PDF supports all of Pandoc's text-based input formats, including Pandoc's Markdown, reStructuredText, Textile, MediaWiki & DokuWiki markup, and DocBook. It supports PDF generation via Pandoc's
ms output formats.
Install from Atom's Settings/Install dialog (search for
pandoc-pdf) or via
apm install pandoc-pdf.
Pandoc needs to be installed. For full functionality, version 2.9.1 or later is necessary.
At least one PDF engine needs to be installed:
If you choose Latexmk, see the Pandoc documentation for a list of the LaTeX packages needed by the default template.
If the input format is Pandoc's Markdown, using the language-markdown package with a supported syntax theme is recommended for writing, but this does not affect the functionality of Pandoc/PDF.
Pandoc/PDF has settings to choose the PDF engine, Pandoc template and defaults file, and configure input file extensions. For a detailed explanation, see the package settings dialog after installation.
The toolbar contains the following buttons:
Triggers reprocessing with Pandoc. Processing occurs in the background, and Pandoc's log messages are shown in the "Pandoc log messages" dialog.
Toggles an overlay dialog with shows the Pandoc call including command line arguments, Pandoc's log messages, and its exit code. The icon is animated during processing, and changes color if warning or error messages are found. If Pandoc aborts processing with an error, the dialog opens automatically.
Pandoc generates the PDF file in a temporary directory along with other files, and opens it from there. This button allows to save the PDF to a user-chosen directory.
Recent versions of Pandoc allow options to be specified in a YAML-format "Defaults
File". Pandoc/PDF checks whether a file with the same name as the document but the extension
.yaml is present in the document's directory, and if
yes, passes it to Pandoc. This button makes it easy to create and edit such a local defaults file.
Opens the temporary directory in the system file browser.
Opens the Pandoc/PDF package settings dialog.
Opens https://pandoc.org/MANUAL.pdf within Atom for quick reference. Note that only a subset of Pandoc's capabilities can be accessed though Pandoc/PDF.
This software is copyrighted © 2020 by Carsten Allefeld and released under the terms of the MIT license.
Good catch. Let us know what about this package looks wrong to you, and we'll investigate right away.