← 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 account at all. On OneDrive it needs the Microsoft connection, which is separate from signing in — see Data protection & permissions.
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.
- Folders inside the manuscript become structure. A folder that holds a note with its own name (its folder note) is a level: that note keeps the folder's level, and everything else in the folder sits one step below it. A folder without one, such as
Frontmatter/, only files things away. The rule and a worked example are on Headings & structure.
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.
- In the wizard the project folder step is labelled “Vault”, with “your Obsidian vault” underneath. Same thing, shorter word. Elsewhere — the settings and the status messages — it is called the project folder.