Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -155,7 +155,7 @@ You can also combine the built-in filter with your own custom Lua filters to cha

### Additional Pandoc command line options

Set additional command line options for each output format.
Set additional command line options for each output format. You can use quoted paths for arguments that contain spaces.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: Based on changes in src/extension.ts that add parseShellArgs function to properly handle quoted arguments. Previously, options were split by simple whitespace, which broke quoted paths.
View source


> default: `$ pandoc inFile.md -o outFile.{pdf|word|html}`

Expand All @@ -177,6 +177,10 @@ To create an HTML5 document:

`pandoc.htmlOptString`: "-s -t html5"

To use a template with a path containing spaces:

`pandoc.pdfOptString`: `--template="/Users/me/My Documents/custom-template.latex"`

> For more information, read the [Pandoc User's Guide](http://pandoc.org/README.html).

## Docker Options
Expand All @@ -191,7 +195,7 @@ Set the `pandoc.docker.enabled` option to `true` and the extension runs Pandoc i

- Default: "pandoc/latex:latest"

- Docker: Options / `pandoc.docker.options`: Additional options to pass to the Docker command when running Pandoc in a container.
- Docker: Options / `pandoc.docker.options`: Additional options to pass to the Docker command when running Pandoc in a container. You can use quoted paths for arguments that contain spaces.

When using Docker, there may be file permission issues with the docker image. For example:

Expand All @@ -210,6 +214,8 @@ If needed, you can also change the default Pandoc docker image using the `pandoc

## Releases

- April 8th, 2026
- Fixed parsing of option strings to support quoted paths containing spaces

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: PR #71 introduced parseShellArgs to replace simple whitespace splitting in both pandocOptions and dockerOptions parsing.
View source

- March 12th, 2026
- Dependency updates
- Export options sorted by usage by default with a setting to override
Expand Down
Loading