← Overview
Obsitex works with two nested levels: the project folder (your whole vault) and the manuscript (the part that becomes your document). Getting these straight makes everything else click.
The two levels
When you convert, you make two choices one after the other:
- Project folder — your whole Obsidian workspace: the folder that contains the
.obsidian folder (marked ● in the picker). It supplies the document order and the images.
- Manuscript — the folder inside it that actually becomes your document. Everything else in the project folder — research, interviews, raw data — stays out.
Project folder
- It is the vault root — the folder that contains
.obsidian.
- Obsitex reads the document order (Flexplorer) and resolves images from here, across the whole vault, even when you convert only a sub-folder.
- On a local drive it needs no Microsoft account. On OneDrive you sign in so Obsitex can read it.
Manuscript
- The folder whose Markdown files are converted, in order, into one document.
- It can be the whole project folder, or any sub-folder, at any depth.
Tips & pitfalls
- If you grant access to a folder that sits below the
.obsidian folder, Obsitex can't find the vault root. Pick the project folder first, then narrow down to the manuscript.
- These two terms — project folder and manuscript — are used consistently across the app: the wizard, the settings, and the status messages.