Quickly export markdown or other text files in Atom to Word, PDF, or any other format supported by Pandoc.
pandoc-interface-yaml is derived from
pandoc-convert-plus. The main differences in this package are:
pandocseparately due to performance concerns. See the upstream repository for a bundled install option.
> brew install pandoc > apm install pandoc-interface-yaml
See the Pandoc site for other installation methods.
Add any of these optional keys to a document's front-matter prior to running
Pandoc Interface > Export (available in the right-click contextual menu, Packages menu, or command palette):
export-path– Set the absolute or relative path for the generated document, including filename and extension. Defaults to the source document's name and directory.
export-format– See lib/targets.js for supported format names. Pandoc will infer format from path; a default format set in the package settings will be used if neither is specified.
export-options– Add other command line options for
For example, the start of file
draft.md might look like:
--- export-path: 'blog-post.html' export-format: 'html5' export-options: '--filter=pandoc-citeproc' title: 'A Well-Evidenced Screed' bibliography: library.bib csl: chicago-note-bibliography-with-ibid.csl --- As has been well established...
pandocwill be called.)
export-formatare defined in a document.
The rest of this readme is from
pandoc-convert-plus is a fork of the
pandoc-convert plugin for Atom that gives more flexibility to the user, by allowing them to invoke pandoc with additional arguments.
pandoc-convert plugin allowed a user to quickly use pandoc to convert their documents to many different formats with the
Ctrl + P command in atom.
pandoc-convert had one limitation : it didn't allow users to use a set of arguments with the pandoc command that the plugin executed.
With pandoc-convert-plus, you can now use any arguments that you want with pandoc. This allows you to customize how pandoc will convert your document.
No ! Just add them like you would in a Pandoc command through a terminal/command prompt.
Here is an example of some arguments to use a bibliography file, to remove the label of figures, and to use the xelatex engine to generate
--citeproc --bibliography=C:/User/Bibliography/Bibliography_file.bib -fmarkdown-implicit_figures --pdf-engine=xelatex
⚠️ Be careful about spaces and special characters in the file paths present in your arguments. They might lead to issues with Pandoc.
Do you have a single bibliography database that you use in many markdown (
.md) notes ?
If that's so, you can use pandoc-convert-plus to automatically use the citeproc plugin of pandoc along with a .bib file containing your bibliography for all of your conversions.
Here is an example of the arguments that you might use to that end :
-fmarkdown-implicit_figures, et voila !
For example, you can use
xelatex with the argument
pandoc-convert-plus is just a tiny modification of the original
pandoc-convert, please check the repository page of
pandoc-convert for more information about its functioning.
Good catch. Let us know what about this package looks wrong to you, and we'll investigate right away.