Instapaper Import

Parse Instapaper highlight exports and create slipbox entries for user's notes.

Input Format

# [Article Title]
> Original highlight from article (SKIP)
User's note about the highlight (IMPORT)
> Another highlight (SKIP)
Another user note (IMPORT)

Key distinction: - > lines = Original article highlights → Skip these - Plain text lines = User's own ideas/takeaways → Import these as notes

Parsing Rules

Header Line

1. Extract title from: # [Title]
2. URL may be instapaper-private://... (private) or regular URL
3. Source type: article
4. Author: null (Instapaper doesn't include author)

Content Lines

1. Lines starting with > = original highlights → skip
2. Plain text lines after > lines = user notes → import
3. Empty lines → skip
4. Each user note becomes a separate slipbox entry

Workflow

1. Parse header → extract article title and URL
2. Extract user notes → collect plain text lines (not starting with >)
3. Precheck → show user: article title, note count, ask for confirmation
4. On confirmation → for each note, invoke slipbot:
5. Type: note (- prefix)
6. Source: ~ article, {title}
7. Let slipbot handle: filename, tags, links, graph update
8. Report → count of notes created

Example

Input:

# [How to Learn Faster]
> Get feedback more often
To learn faster we need faster feedback loops.
> Latent learning occurs without reinforcement
Testing yourself proactively speeds up learning.

Extracted notes: 1. "To learn faster we need faster feedback loops." 2. "Testing yourself proactively speeds up learning."

Slipbot calls:

- To learn faster we need faster feedback loops. ~ article, How to Learn Faster
- Testing yourself proactively speeds up learning. ~ article, How to Learn Faster

Edge Cases

• No user notes (only > lines): Report "no notes to import"
• Multi-line user notes: Treat each paragraph as separate note
• Title with special chars: Preserve as-is for source metadata