Download Folder Setup Guide

Where Your Files Go

All exported markdown files are saved to:

Downloads/{your-folder-name}/

For example:

• Setting: obsidian → Files go to Downloads/obsidian/
• Setting: vault/daily → Files go to Downloads/vault/daily/

This makes it easy to point your Obsidian vault or other markdown tools directly at the export location.

---

Path Rules & Validation

The extension enforces strict rules to keep your file system safe and organized:

✅ Allowed Paths

Single folder:

obsidian
my-vault
claude-exports

Nested folders (max 2 levels):

obsidian/daily
vault/archive
notes/claude

❌ Rejected Paths

Absolute paths:

/Users/you/Documents/obsidian     ❌ Must be relative
C:\Users\you\Documents\obsidian   ❌ Must be relative

Parent directory traversal:

../other-folder    ❌ Security risk
../../escape       ❌ Security risk

Too deep (more than 2 levels):

vault/2024/march/daily    ❌ Max 2 levels
a/b/c/d                   ❌ Max 2 levels

Illegal characters:

folder<name>     ❌ Contains <>
vault:notes      ❌ Contains :
my|folder        ❌ Contains |
folder?name      ❌ Contains ?
folder*name      ❌ Contains *

Windows reserved names:

con       ❌ Reserved device name
prn       ❌ Reserved device name
aux       ❌ Reserved device name
nul       ❌ Reserved device name
com1-9    ❌ Reserved device name
lpt1-9    ❌ Reserved device name

Trailing dots or spaces:

folder.      ❌ Invalid on Windows
folder       ❌ (with trailing space)

---

How to Set Your Folder

In the Popup (Quick Save)

1. Open the extension popup on any Claude chat page
2. Find the “Download Folder” input field
3. Type your desired path (e.g., obsidian or vault/daily)
4. Click outside the input box or press Tab to trigger validation
5. If valid, the path is saved automatically
6. If invalid, you’ll see a red error message explaining the issue

In the Options Page (Batch Sync)

1. Right-click the extension icon → “Options” (or click the layers icon in popup)
2. Scroll to “Connect Obsidian” section
3. Find the folder input under “Configure download folder”
4. Type your desired path
5. Click outside the input box or press Tab to trigger validation
6. Valid paths show a green checkmark; invalid paths show a red error

---

Why These Rules Exist

Security: Absolute paths and .. traversal could write files anywhere on your system, potentially overwriting important files.

Compatibility: Illegal characters cause errors on Windows, macOS, or Linux. Reserved names like con crash Windows file operations.

Organization: Limiting depth to 2 levels keeps your export structure simple and prevents deeply nested folder chaos.

Reliability: Validation happens on blur (when you leave the input field), not on every keystroke, so you can type freely without premature errors or window closures.

---

Common Scenarios

Obsidian Vault Integration

Setting: obsidian
Result: Downloads/obsidian/
Action: Point your Obsidian vault to Downloads/obsidian/

Organized by Date

Setting: claude/2024
Result: Downloads/claude/2024/
Action: Create monthly subfolders manually if needed

Shared Team Folder

Setting: team-exports
Result: Downloads/team-exports/
Action: Sync this folder with Dropbox/Drive for team access

Default Behavior

Setting: (empty or invalid)
Result: Downloads/obsidian/
Action: Extension falls back to "obsidian" as default

---

Troubleshooting

“Path too long (max 100 chars)” → Shorten your folder names. Most users need 10-20 characters max.

“Max 2 levels allowed” → Remove extra subdirectories. Use vault/daily instead of vault/2024/march/daily.

“Invalid characters in path” → Remove special characters like <>:"|?*. Use letters, numbers, hyphens, and underscores only.

“Reserved name: con” → Windows blocks device names. Use console or config instead.

“Only relative paths allowed” → Remove leading / or drive letters like C:. Start with a folder name directly.

Input keeps resetting → Make sure you click outside the input box or press Tab to trigger validation. The extension only saves on blur, not on every keystroke.

---

Best Practices

1. Keep it simple: Use a single folder name like obsidian or vault unless you need organization.
2. Use hyphens or underscores: Avoid spaces in folder names for better cross-platform compatibility.
3. Test first: Try saving a single chat before running batch sync to verify your folder setup works.
4. Check Downloads: After your first export, open your Downloads folder to confirm files landed in the right place.
5. Obsidian setup: If using Obsidian, create a vault pointing directly at Downloads/obsidian/ for seamless integration.

---

Technical Details

The extension uses a validation utility (path-validator.ts) that:

• Normalizes path separators to / for cross-platform consistency
• Splits paths into segments and validates each one
• Checks against a regex of illegal characters: [<>:"|?*\x00-\x1f]
• Matches Windows reserved names case-insensitively
• Enforces a maximum depth of 2 and length of 100 characters
• Returns normalized paths (e.g., vault\\daily becomes vault/daily)

Validation runs only on blur (when you leave the input field), not on every keystroke. This prevents:

• Premature error messages while typing
• Excessive storage writes
• Popup window closures mid-input

---

Need Help?

• Docs: https://chatgpt2notion.com/docs/claude-to-obsidian/installation/
• GitHub Issues: https://github.com/joysey/chatgpt-to-notion/issues
• Email: [email protected]

Keep your Claude conversations organized. Set your folder once, export forever.