Is It Safe to Upload My Jupyter Notebook to an Online Converter?
A practical guide to the privacy and security of online IPYNB to PDF converters. What happens to your file, what to look for in a provider, and when to stay local.
- #security
- #privacy
- #online
Online IPYNB to PDF converters are convenient, but they raise an obvious question: should you trust a random website with your notebook? Notebooks often contain proprietary code, sensitive datasets, API keys, or unpublished research. Uploading the wrong one to the wrong service can be a career-limiting move.
This guide explains what actually happens to your file, what to look for in a trustworthy provider, and when you should stay local.
What Happens to Your File
When you upload a .ipynb to a typical online converter, the workflow looks like this:
- HTTPS upload. Your browser sends the file over an encrypted connection to the server.
- Server-side processing. The server parses the notebook, renders cells, generates a PDF.
- Temporary storage. The notebook and PDF sit on the server's disk during processing.
- Download. Your browser fetches the PDF.
- Cleanup (hopefully). The server deletes the notebook and PDF.
The risk lives in steps 2, 3, and 5. Let's look at each.
Server-side Processing (Step 2)
A well-built converter treats your notebook as inert JSON — it parses the cells, renders markdown, embeds images, and produces a PDF. It does not execute the code cells. This is important because:
- No code execution means no risk of malicious code in your notebook running on the server.
- The outputs you see in the PDF are the ones baked into the notebook at save time.
If a converter claims to "execute your notebook online," it's running arbitrary Python — a much bigger security surface. Stick with converters that render but don't execute.
Temporary Storage (Step 3)
During processing, your notebook exists on the server's disk. Questions to ask:
- Is the disk encrypted?
- Is the processing isolated per-customer (containers, VMs)?
- Are logs scrubbed of notebook contents?
You can't verify any of this from the outside, which is why trust signals (HTTPS, privacy policy, age of the service) matter.
Cleanup (Step 5)
The single most important question: does the converter actually delete your file after conversion? Look for:
- An explicit deletion policy in the privacy statement.
- Automated deletion (e.g., "files are deleted within 5 minutes of conversion").
- Public statements about zero retention.
ipynbtopdf.org, for example, deletes files automatically after conversion. Look for the same commitment from any provider you use.
Red Flags
Avoid any online converter that:
- Uses HTTP, not HTTPS. If the URL doesn't start with
https://, your file is being uploaded in plaintext. Leave immediately. - Has no privacy policy. If they don't tell you what happens to your file, assume the worst.
- Asks you to create an account to download. Some sketchy sites use the conversion as bait to harvest email addresses.
- Has pop-up ads or redirects. Reputable tools don't need to.
- Was registered last week. Check the domain's age. Newer services have less to lose from a breach.
- Claims to "execute" your notebook. This means they're running arbitrary Python — a major security surface.
- Is a generic "PDF converter" that also handles Word, Excel, etc. These usually mangle
.ipynbfiles anyway, and their security model is built for office documents, not code.
Green Flags
A trustworthy online converter typically:
- Uses HTTPS everywhere, with a valid certificate.
- Has a clear, specific privacy policy that mentions file deletion.
- Specializes in
.ipynbfiles rather than being a generic converter. - Has been around for a while (a year or more).
- Renders but doesn't execute notebooks.
- Doesn't require an account for basic conversion.
- Is open about its tech stack (e.g., "powered by nbconvert and Playwright").
When to Stay Local
Online converters are fine for most notebooks. But you should switch to a local converter (like nbconvert) when the notebook contains:
- PII (names, emails, phone numbers, addresses)
- Financial data (especially covered by regulations like GDPR, CCPA, or HIPAA)
- Credentials (API keys, passwords, tokens — even if you think you've removed them)
- Unpublished research (especially pre-submission)
- Proprietary company data (especially if your employment agreement restricts third-party processing)
- Client data covered by an NDA
When in doubt, ask yourself: "Would I be comfortable if this file appeared in a public GitHub repo tomorrow?" If the answer is no, convert locally.
How to Sanitize a Notebook Before Uploading
If you want to use an online converter but the notebook has sensitive content, you can sanitize it first:
Remove Outputs
jupyter nbconvert --clear-output --to notebook notebook.ipynb --output notebook-clean.ipynb
This strips all outputs (including any embedded data in charts). You'll lose the rendered content, but the code structure is preserved.
Strip Specific Cells
Use nbstripout or manually delete sensitive cells before uploading.
Scrub Embedded Data
If your notebook embeds a pandas DataFrame as output, that data is in the .ipynb JSON. Re-run with df.head() instead of df to limit what's exposed.
Check for Hardcoded Secrets
Before uploading, search the notebook for common secret patterns:
grep -E "(api_key|password|secret|token)" notebook.ipynb
Or use a tool like truffleHog to scan for credentials.
What ipynbtopdf.org Does
For transparency, here's what happens when you upload a notebook to ipynbtopdf.org:
- HTTPS upload to an encrypted endpoint.
- Render-only processing — your code cells are parsed as text and rendered with syntax highlighting. They are not executed.
- Automatic deletion — your notebook is deleted from the server shortly after conversion. No long-term retention.
- No account required — no email or signup needed.
- Specialized for
.ipynb— not a generic file converter.
That said, the local-converter rule above still applies. If your notebook has PII or credentials, keep it local.
The Pragmatic Posture
For most data scientists, most of the time, the risk calculus looks like this:
- Notebook contains public data or no real data → online converter is fine.
- Notebook contains internal company data that isn't regulated → online converter is probably fine, but check your company's policy.
- Notebook contains regulated or sensitive data → convert locally with
nbconvert.
The convenience of online conversion is real, and for the majority of notebooks (homework, tutorials, demos, public analyses), the risk is negligible. Just don't upload the one notebook with the production database password in cell 3.
Conclusion
Online IPYNB to PDF converters can be safe — but only if you choose a reputable one and use it for the right notebooks. Look for HTTPS, a clear deletion policy, and a provider that specializes in .ipynb files. Avoid generic converters, account-harvesting sites, and anything that tries to execute your code. And when the notebook contains anything you wouldn't post publicly, stay local. The convenience isn't worth the risk.