tinykoi
All posts

Highlights and notes: keeping the passages that matter

· Product · 5 min read

You can highlight web pages in tinykoi by opening a saved page in the reader, selecting some text and picking one of five colours. Add a note to any highlight if you want to remember why you kept it. Highlights and notes are on the free plan as well as Pro, and you can export all of them as Markdown whenever you like.

Most people save a page because of one paragraph. A week later they have the page and no idea which paragraph it was. Highlights fix that.

How to highlight web pages in the reader

Open any saved page in the reader view. Select a passage with your mouse or finger, and a small toolbar appears next to it with five colour swatches: yellow, green, blue, pink and purple. Click one and the passage is saved as a highlight.

On a narrow screen or a touch device the toolbar docks to the bottom edge instead of floating over the text, so it stays clear of the system selection menu.

The highlights belong to the bookmark, not to your browser. Open the same page tomorrow, on another computer, and the colours are still there.

Click an existing highlight and the same toolbar comes back with three extra options:

  • Pick a different colour to recolour it.
  • Choose Note to type a note against that passage.
  • Choose Delete to remove the highlight.

A note can be up to 10,000 characters, so it can hold a proper thought rather than a label. A single bookmark can carry up to 1,000 highlights, which is more than most articles will ever need.

What the five colours are for

tinykoi does not attach a meaning to the colours. That is your call, and it works best if you decide once and stick to it. A few schemes people use for paper books carry over well:

  • Yellow for anything worth remembering, green for things to try, pink for things you disagree with.
  • One colour per project, if you read for several at the same time.
  • Blue for definitions and purple for quotes you might reuse.

The colours are only a visual cue. They are not a filter or a search facet, so do not build a system that depends on searching by colour. Use tags for that, and see collections or tags for how to split the work between the two.

Notes turn a highlight into something you can use

A highlight alone says "this mattered". A note says why. Compare these two entries from the same article on database indexes:

Partial indexes only cover rows that match a condition.

Without a note, you will wonder in a month what you were meant to do about it. With one, the entry reads: "Try this on the orders table, most rows are archived."

Notes are plain text and sit directly under the quote in the export, so they survive being moved to another tool.

Find a page again from its highlights

Open a bookmark in the reader and press the Highlights button. A panel lists every passage you marked on that page, with its colour and note. Choosing one jumps to the passage in the article.

That makes a long page cheap to revisit. You do not reread the article, you reread the six lines you decided were worth keeping.

If you are trying to find a page you saved but cannot name, search is the faster route. Full-text search looks inside every saved page, which is covered in full-text search for bookmarks.

Exporting your highlights as Markdown

Your highlights are yours to take elsewhere, and tinykoi gives you two ways to do it.

One page at a time. In the reader's Highlights panel, Copy as Markdown puts that page's highlights on your clipboard, and Download .md saves them as a file. Both are disabled until the page has at least one highlight.

Everything at once. Go to Settings, then Import and export, and choose Export highlights (Markdown). You get a zip with one Markdown file per bookmark that has highlights. Bookmarks in the trash are skipped. If you have no highlights yet, the zip contains a short README instead of nothing.

Each file starts with YAML frontmatter:

  • title, url and domain of the page
  • collection, if the bookmark is in one
  • tags, if it has any
  • created, the date you saved it, and highlighted, the date of your newest highlight
  • tinykoi, a link back to the page in the reader

Below that is a heading with the page title, then each highlight in reading order. Quotes are Markdown blockquotes, and a note appears as a plain paragraph underneath its quote. The files open cleanly in any editor that reads Markdown, including folder-based note apps.

File names are the page title as a lowercase slug plus eight characters from the bookmark's id, so two pages with the same title never overwrite each other.

Highlights and the API

If you prefer scripts, the REST API has routes for highlights. You can list a bookmark's highlights, create one, change its colour or note, and delete it. Create and update need an API key with write access. The reference at /api/v1 lists the exact fields, and automate bookmarks with the API shows how the pieces fit together.

What highlights will not do

Be clear about the limits so you do not rely on something that is not there.

  • Highlights live in the tinykoi reader. They do not appear on the original website, and the Chrome extension does not paint them onto pages as you browse.
  • Highlighting needs the page text, so it works where the reader can show the page. PDFs, text and Markdown files open in the reader too.
  • If a page changes on the live web, your highlights stay attached to the text tinykoi saved, not to the live page. On Pro, the archived copy keeps the original page itself as well. How to archive a web page covers what that gives you.

Try it on one article

Pick one long article you are halfway through, save it, and highlight the three lines you would otherwise copy into a document. Add one note. Then open Settings and export the highlights, and look at the file.

If that file is something you would actually keep, the habit will stick. Sign up for the free plan, no card needed, and see what else is in the reader.