Import data into Keep

Use an import to move an existing library into Keep. Use Capture for ordinary files, links, audio, and screenshots.

The free Word to Markdown converter, Google Docs to Markdown converter, and Confluence to Markdown converter create portable files. The EPUB to Markdown converter turns an ebook into one Markdown file.

Open the import tools

1. Open Settings.
2. Open Data.
3. Find Import.
4. Select an import type.

You can also press Command K or Control K and search for an import action. Dropping a recognised import file anywhere in the app opens the same preview.

Import from another service

Keep can identify exports from these services:

• Pocket
• Instapaper
• Omnivore
• Raindrop.io
• Pinboard
• Wallabag

Exports can be ZIP, CSV, TSV, HTML, JSON, or XML, depending on the service.

1. Select Import from file.
2. Choose the export file.
3. Review the detected service and preview.
4. Choose whether Keep should fetch full content or create summaries when those options are available.
5. Select Import.

Keep preserves available titles, URLs, notes, tags, collections, saved dates, archive state, starred state, and highlights.

Import CSV or TSV data

The file must contain a header row. A URL column is required. Keep recognises common names such as url, link, href, source_url, and article_url.

Optional columns can contain:

• title
• notes
• tags
• saved date
• collection
• archive or starred state

Map any column that Keep cannot identify in the preview. Check the first rows before you start the import.

Import browser bookmarks

Export bookmarks from the browser as HTML. Upload that file through Import from file.

For Safari Reading List data on macOS:

1. Select Import from Safari.
2. Select the file picker.
3. Press Shift Command G.
4. Enter ~/Library/Safari/Bookmarks.plist.
5. Select the file.
6. Review the preview.
7. Select Import.

Keep accepts binary and XML property lists.

Import X bookmarks

1. Export your X bookmarks as CSV or JSON with a browser exporter.
2. Open Import in Keep.
3. Select Import from file for CSV or generic JSON. Select Import X bookmarks only for a compatible Keep-format JSON export.
4. Select the export file.
5. Review the preview.
6. Select Import.

The generic importer maps available URLs, titles, notes, tags, and saved dates. A compatible Keep-format file can preserve richer captured post content and metadata. Paid plans can also process available full content.

The Keep import walkthrough covers file formats and what to do after a browser exporter writes CSV or JSON.

Import Kindle clippings

Select your Kindle My Clippings.txt file. Keep creates one Item for each book and keeps its highlights, notes, and locations.

See Kindle for the complete procedure.

Import subscriptions from OPML

Use OPML to move feed subscriptions from another feed reader.

1. Select Import OPML.
2. Choose the .opml or .xml file.
3. Review the feeds.
4. Start the import.

Keep adds valid feeds as sources. Duplicate sources are skipped.

Drop a Markdown file

A .md or .markdown file is not imported as an Item. Keep creates a Note, preserves supported frontmatter, and opens the Note editor.

See Notes for Note properties and revisions.

Tags and processing

Imported Items receive an imported tag. Service imports also receive a tag for the source service. Safari Reading List Items receive safari and reading-list. Kindle Items receive kindle and use a Kindle collection.

Free accounts keep available link metadata. Paid processing can fetch full content and create summaries. You can leave the page after an import starts.

Duplicate Items are skipped. Each import job accepts up to 1,000 Items. Split a larger export into more than one file.