Skip to content

highlight

A personal extraction from a source — a passage you highlighted, annotated, or saved. Different from a quote: a highlight is YOUR selection from a work. A quote is a canonical attribution to a speaker.

MetadataValue
Pluralhighlights
FieldType
positionstring
colorstring
RelationTarget
extractedFrombook
createdByperson

External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.

  • W3C Web Annotation Data Model — Our extractedFrom = target; createdBy = creator; position ≈ TextPositionSelector/TextQuoteSelector; color ≈ rendering preference.
  • Hypothes.is annotation schema — Practical W3C-compatible implementation. Our highlight is shaped like a Hypothes.is annotation minus the body text.
  • Readwise Reader API — Practical source. Our color/position come directly from Readwise’s highlight export.