From your files
Most docs already exist somewhere — in a Notion wiki, a PDF, a Google Doc, a Slack thread, a markdown folder. Docsio reads any of it and turns it into a polished public docs site.
When to use it
- You have internal docs that aren't public-facing yet.
- Your product website is too thin to derive docs from.
- You want full control over the source content the AI sees.
- You're migrating from another tool and have a folder of markdown.
Supported formats
Drop in any combination of:
- Markdown (
.md,.mdx) - Plain text (
.txt) - PDF (
.pdf) - Word documents (
.docx) - HTML pages (
.html) - API specs (OpenAPI / Swagger JSON or YAML)
- Whole folders containing the above
The AI agent reads everything, deduplicates overlapping content, and structures it.
How it works
-
Click "Upload files" on the New project screen. Drag in your folder or pick individual files.
-
Docsio extracts the text. PDFs, Word docs, HTML — all flattened to clean markdown the AI can reason about.
-
The agent proposes a plan. Before writing anything, the AI shows you a categorized outline of the doc site it would build. Review, suggest changes, approve.
-
Generation runs. The agent writes every page based on your source material — preserving facts, restructuring for documentation voice, adding navigation between related pages.
-
You land in the editor with a fully populated docs site, ready to review and refine.
Plan-mode approval
Unlike URL mode (where Docsio just goes), file mode pauses to show you the plan first. Why: file content is more variable than scraped websites, so it's worth confirming the structure before generating.
The plan is interactive. You can:
- Suggest different categories ("merge Integrations and API into one section")
- Reorder pages
- Tell the agent to drop or add specific topics
- Adjust the depth ("keep it to one page per feature, no sub-pages")
Once you approve, generation runs.
Tips for best results
- Cleaner sources, cleaner output. A well-organized PRD produces better docs than a Slack thread, even though Docsio handles both.
- Don't worry about duplication. If three files cover the same topic, the agent will merge them.
- Bring branding separately. File mode doesn't auto-extract a brand the way URL mode does. Set logo, favicon, and primary color from project settings or ask the agent ("set primary color to #5B6CFF and use the logo I uploaded as
logo.svg"). - Big folders are fine. A few hundred files works. Past that, generation slows down.
Mixed mode (URL + files)
After URL-based generation, you can drag files into the editor's chat any time. The agent treats them as additional source material — "use this PDF to flesh out the API reference section" works exactly as you'd expect.