diff --git a/doc/faqs.md b/doc/faqs.md index 317153d5f..82de2d780 100644 --- a/doc/faqs.md +++ b/doc/faqs.md @@ -134,3 +134,21 @@ example, ::: +## When I convert from ipynb, some visualizations aren't showing up. + +First, unless your target is a binary format (docx, odt, epub), +you must use either `--extract-media` or (for HTML only) +`--self-contained` to make the images in the ipynb container +available to your output file. + +Second, some Jupyter extensions, especially those that use JavaScript +for visualizations, assume the presence of +[`require.js`](https://github.com/requirejs/requirejs). +To ensure that this script is available in your HTML output, you +can use: + +``` +pandoc -s -o output.html input.ipynb \ +-V header-includes='' +``` +