Export/Import Notes

Purpose

Export and import the three types of structured notes generated by literature-analysis (digest, references, citation analysis), facilitating migration between Zotero instances.

Editing Analysis Results

Notes generated by Literature Analysis are rendered from backend data; directly modifying the note content will not change the backend data. If you need to edit analysis results, the correct approach is: Export Notes → modify the exported files → use Import Notes to re-import.

export-notes (Export Notes)

Use Cases

• Share literature analysis results with collaborators
• Import analysis results in another Zotero instance
• Back up literature analysis artifacts

Input Constraints

Constraint Type	Description
Input Unit	Parent item
Selection Method	Supports mixed selection of parent items and three types of notes
Multi-select Behavior	Only one export directory selection dialog is shown for multi-select

Exported Artifacts

File	Description
digest.md	Literature digest Markdown
references.json	Reference list JSON
citation_analysis.json	Citation analysis data JSON
citation_analysis.md	Citation analysis report Markdown
representative_image.jpg	Representative image (when digest note contains an embedded image)

The representative image is inserted into digest.md as a zs:representative-image:v1 Markdown comment block, referenced using a same-directory relative path. Image export failure does not block the export of text and JSON artifacts.

Estimated Duration

Completed in seconds (purely local file operations, no backend required).

import-notes (Import Notes)

Use Cases

• Restore literature analysis results in another Zotero instance
• Import analysis artifacts shared by collaborators

Input Constraints

Constraint Type	Description
Input Unit	Single parent item
Import Method	Select a directory containing exported artifacts

Import Flow

1. Select Import Directory
   └── Directory should contain digest.md, references.json, citation_analysis.json

2. Structure Validation
   └── references.json and citation_analysis.json undergo structure validation before becoming candidates
       └── Validation failure shows a warning but does not block import of other artifacts

3. Image Parsing
   └── If digest.md contains a zs:representative-image:v1 marker block
       └── Automatically parse the representative image from the same directory
       └── User can also manually select or clear the representative image

4. Write
   └── Create/update corresponding notes under the parent item

Image import failure does not block digest note import.

Dependencies

• No backend connection required
• Only relies on Zotero local storage

Related Workflows

• Literature Analysis — Generate the three types of exportable notes