Bookmarks Html To Markdown API

POST https://api.findutils.com/api/tools/bookmarks-html-to-markdown/execute

Convert a browser bookmarks.html export (the Netscape bookmark format Chrome, Firefox, Edge and Safari write) into Markdown for Notion, Obsidian or a README. In the default "headings" style each folder becomes an ATX heading nested by depth (## for a top-level folder, ### below it, up to ######) and each bookmark a "- [title](url)" line under its folder, in the order the export lists them; "list" style writes one flat bullet list with the folder path before each link. The document starts with a # heading named after the export (or the title argument), and front_matter adds a YAML block with that title. A bookmark with no title is named after its host. Entities are decoded, Markdown characters in titles are escaped, favicon data is never written, and no link is fetched. An ordinary web page is refused: it has links but no bookmark folder structure.

Needs an API key. Running a tool needs an API key. Keys are not for sale yet: ask for early access. About API keys

Open the tool Try it

Request body

application/json

input

string required

The bookmarks.html file contents.
style

string optional

"headings" (default): folders as nested headings with link lists under them. "list": one bullet list, each link prefixed with its folder path. One of headings · list. Default "headings".
include_dates

boolean optional

Add "(added YYYY-MM-DD)" after a link when the export carries its ADD_DATE. Default false. Default false.
front_matter

boolean optional

Start the file with a YAML front matter block holding the title. Default false. Default false.
include_empty_folders

boolean optional

Headings style: also write a heading for a folder that holds no links. Default false. Default false.
title

string optional

Document title. Default: the export's own <H1>, else "Bookmarks".

Example arguments

Verified

{
  "input": "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<TITLE>Bookmarks</TITLE>\n<H1>Bookmarks</H1>\n<DL><p>\n    <DT><H3 ADD_DATE=\"1600000000\">Work</H3>\n    <DL><p>\n        <DT><A HREF=\"https://example.com/\" ADD_DATE=\"1600000000\">Example</A>\n    </DL><p>\n</DL><p>\n"
}

curl -X POST https://api.findutils.com/api/tools/bookmarks-html-to-markdown/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<TITLE>Bookmarks</TITLE>\n<H1>Bookmarks</H1>\n<DL><p>\n    <DT><H3 ADD_DATE=\"1600000000\">Work</H3>\n    <DL><p>\n        <DT><A HREF=\"https://example.com/\" ADD_DATE=\"1600000000\">Example</A>\n    </DL><p>\n</DL><p>\n"
  }'

const response = await fetch('https://api.findutils.com/api/tools/bookmarks-html-to-markdown/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
  body: JSON.stringify({"input":"<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<TITLE>Bookmarks</TITLE>\n<H1>Bookmarks</H1>\n<DL><p>\n    <DT><H3 ADD_DATE=\"1600000000\">Work</H3>\n    <DL><p>\n        <DT><A HREF=\"https://example.com/\" ADD_DATE=\"1600000000\">Example</A>\n    </DL><p>\n</DL><p>\n"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/bookmarks-html-to-markdown/execute",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"input":"<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<TITLE>Bookmarks</TITLE>\n<H1>Bookmarks</H1>\n<DL><p>\n    <DT><H3 ADD_DATE=\"1600000000\">Work</H3>\n    <DL><p>\n        <DT><A HREF=\"https://example.com/\" ADD_DATE=\"1600000000\">Example</A>\n    </DL><p>\n</DL><p>\n"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/bookmarks-html-to-markdown/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => '{"input":"<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<TITLE>Bookmarks</TITLE>\n<H1>Bookmarks</H1>\n<DL><p>\n    <DT><H3 ADD_DATE=\"1600000000\">Work</H3>\n    <DL><p>\n        <DT><A HREF=\"https://example.com/\" ADD_DATE=\"1600000000\">Example</A>\n    </DL><p>\n</DL><p>\n"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call bookmarks_html_to_markdown from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: API key
REST id: bookmarks-html-to-markdown
MCP name: bookmarks_html_to_markdown
Category: Text
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Text tools

More to explore