Upgrade StorageNew plugin: Folio – semantic PDF annotation, margin labels, and structured reading notes
Hi all,
I'd like to share Folio (知页), a Zotero plugin I built to help organize the process of reading and annotating research papers.
https://github.com/panhh0804/folio-zotero
When reading a paper, I often highlight passages for different reasons: a research problem, an interesting insight, a proposed method, or an important result. Folio lets you assign these roles to passages and keeps the labels visible in the PDF margins, so you can see the structure of a paper as you read. You can then export the annotated passages and your comments as structured Markdown reading notes.
Main features:
- Manual semantic annotation: select a passage and assign a category from the PDF selection popup or the Folio panel.
- Persistent margin labels: labels stay beside their corresponding highlights and scale with the PDF zoom level.
- Customizable categories: the defaults are Motivation, Problem, Insight, Solution, Result, and Limitation. You can edit their names, definitions, and colors.
- Optional AI assistance: generate suggested annotations for a paper, then review, accept, or reject them before saving.
- Comments and translation: add comments to individual annotations and, with Translate for Zotero installed, translate passages from the Folio panel.
- Markdown export: organize passages by category, with page references, comments, and optional translations.
Ordinary highlights can remain independent of semantic categories. You can also remove Folio annotations in bulk by source and restore the most recent removal.
Manual annotation does not require an API key. AI assistance requires your own API configuration; when using a remote provider, paper text is sent to that provider with your permission.
Install: download the .xpi file from the latest release (https://github.com/panhh0804/folio-zotero/releases/latest), then go to Tools → Plugins → gear icon → Install Plugin From File in Zotero.
The current version targets Zotero 10.0.7–10.0.x and has been tested on macOS with Zotero 10.0.7. The interface is currently in Chinese, and an English README (https://github.com/panhh0804/folio-zotero/blob/main/README.en.md) is available. Feedback from Windows and Linux users would be very welcome.
Folio is open source under the Apache 2.0 license. Special thanks to Keylight (https://keylight.pacificstudio.ai/) for the inspiration.
Bug reports, suggestions, and feedback are welcome on GitHub (https://github.com/panhh0804/folio-zotero/issues) or here.
Thanks!
Haohao Pan
I'd like to share Folio (知页), a Zotero plugin I built to help organize the process of reading and annotating research papers.
https://github.com/panhh0804/folio-zotero
When reading a paper, I often highlight passages for different reasons: a research problem, an interesting insight, a proposed method, or an important result. Folio lets you assign these roles to passages and keeps the labels visible in the PDF margins, so you can see the structure of a paper as you read. You can then export the annotated passages and your comments as structured Markdown reading notes.
Main features:
- Manual semantic annotation: select a passage and assign a category from the PDF selection popup or the Folio panel.
- Persistent margin labels: labels stay beside their corresponding highlights and scale with the PDF zoom level.
- Customizable categories: the defaults are Motivation, Problem, Insight, Solution, Result, and Limitation. You can edit their names, definitions, and colors.
- Optional AI assistance: generate suggested annotations for a paper, then review, accept, or reject them before saving.
- Comments and translation: add comments to individual annotations and, with Translate for Zotero installed, translate passages from the Folio panel.
- Markdown export: organize passages by category, with page references, comments, and optional translations.
Ordinary highlights can remain independent of semantic categories. You can also remove Folio annotations in bulk by source and restore the most recent removal.
Manual annotation does not require an API key. AI assistance requires your own API configuration; when using a remote provider, paper text is sent to that provider with your permission.
Install: download the .xpi file from the latest release (https://github.com/panhh0804/folio-zotero/releases/latest), then go to Tools → Plugins → gear icon → Install Plugin From File in Zotero.
The current version targets Zotero 10.0.7–10.0.x and has been tested on macOS with Zotero 10.0.7. The interface is currently in Chinese, and an English README (https://github.com/panhh0804/folio-zotero/blob/main/README.en.md) is available. Feedback from Windows and Linux users would be very welcome.
Folio is open source under the Apache 2.0 license. Special thanks to Keylight (https://keylight.pacificstudio.ai/) for the inspiration.
Bug reports, suggestions, and feedback are welcome on GitHub (https://github.com/panhh0804/folio-zotero/issues) or here.
Thanks!
Haohao Pan