Keep to Markdown

What this tool does

Google Takeout hands your Keep notes back as a folder of one .json (and one .html) file per note — machine-readable, but not something you can read or drop into a notes app. This tool turns that export into Markdown: one clean .md note per Keep note, with the labels, the checkboxes, the dates and the pinned/archived flags all preserved.

Everything runs locally in WebAssembly. Your notes are never uploaded, and the page keeps working offline once it has loaded.

What you paste in

The input format is auto-detected:

• One note's JSON — the contents of a Takeout/Keep/<note>.json file (title, textContent or listContent, labels, createdTimestampUsec, …).
• A JSON array of notes — paste several notes as [ {...}, {...} ] to convert a whole batch in one go.
• The Keep HTML export — the Takeout/Keep/<note>.html file, including its checklist glyphs and label chips.

What you get

Each note becomes one Markdown file in the output, preceded by an ==== filename.md ==== header so you can see — and split out — every file:

• A # Title heading (or, for untitled notes, a filename taken from the first line).
• Checklist items as - [ ] / - [x] task list items.
• Labels, as a YAML labels: list or as #hashtags.
• Created / last-edited timestamps, converted from Keep's microsecond values to ISO‑8601 UTC.
• The pinned, archived and note color flags, when set.
• A Markdown link per attachment, and the note's link chips as a link list.

Options

Example

Paste this Keep Takeout note:

{ "title": "Grocery List", "color": "BLUE", "isPinned": true,
  "labels": [{ "name": "Shopping" }, { "name": "Home" }],
  "createdTimestampUsec": 1768469400000000,
  "userEditedTimestampUsec": 1768557600000000,
  "listContent": [
    { "text": "Milk", "isChecked": false },
    { "text": "Eggs", "isChecked": true } ] }

…with frontmatter metadata, date-title filenames and task-list checkboxes, and you get:

==== 2026-01-15-grocery-list.md ====
---
title: "Grocery List"
created: 2026-01-15T09:30:00Z
updated: 2026-01-16T10:00:00Z
labels: ["Shopping", "Home"]
pinned: true
color: BLUE
---

# Grocery List

- [ ] Milk
- [x] Eggs

Limits and edge cases

• Input size: up to 4 MB of pasted text per run. Convert a large Takeout folder in batches.
• Attachments are links, not files. Takeout stores photos and voice clips as separate files next to the notes; this page only ever sees the text you paste, so it writes the Markdown link and leaves the file where it is. Copy the Keep attachment files next to your .md notes and the links resolve.
• No folder tree, no file times. The browser has no filesystem, so the output is one labeled text bundle; label-title encodes the folder in the header name rather than creating directories, and original file timestamps cannot be set.
• .zip / .tgz Takeout archives are not accepted — unzip the download and paste the note files (or the whole array of them).
• Nested checklist items flatten. Keep's export does not record checklist indentation, so sub-items come out at the top level.
• HTML export dates are local. Keep writes the heading date without a time zone; it is carried through as-is with a Z suffix. The JSON export's microsecond timestamps are true UTC.

FAQ