--- title: "Bookmarks HTML to Markdown" description: "Turn a Chrome, Firefox, Edge or Safari bookmarks.html export into Markdown: folders become headings and every link a - [title](url) line, ready for Notion, Obsidian or a README." url: https://findutils.com/convert/bookmarks-html-to-markdown/ category: convert --- # Bookmarks HTML to Markdown Turn a Chrome, Firefox, Edge or Safari bookmarks.html export into Markdown: folders become headings and every link a - [title](url) line, ready for Notion, Obsidian or a README. **Use this tool:** [Bookmarks HTML to Markdown](https://findutils.com/convert/bookmarks-html-to-markdown/) ## Programmatic access - REST id `bookmarks-html-to-markdown`: POST https://api.findutils.com/api/tools/bookmarks-html-to-markdown/execute (reference: https://findutils.com/api/bookmarks-html-to-markdown/) - MCP tool `bookmarks_html_to_markdown` on https://mcp.findutils.com (reference: https://findutils.com/mcp/bookmarks-html-to-markdown/) - Data: The REST API and the MCP tool are a separate path from this page: a call sends the input you include to FindUtils over HTTPS, where it is processed and the result returned. FindUtils does not store that input, and logs the request without its content. ## Why Use Bookmarks HTML to Markdown? Every browser exports bookmarks as a bookmarks.html file in the old Netscape format, and that file is built for importing into another browser, not for reading. Pasting it into Notion or Obsidian gives you raw HTML, and a general HTML to Markdown converter flattens the folder tree into one long run of links. This page reads the export's folder structure and writes Markdown that keeps it: each folder becomes a heading one level below its parent, and each bookmark becomes a - [title](url) list item under its folder, in the order the browser listed them. You can switch to one flat list with the folder path before each link, add the date each bookmark was saved, or start the file with YAML front matter for a notes vault. ## Tips for Bookmarks in Markdown - Nested headings start at ## for a top-level folder because the file's # heading is the export's own title. Markdown has six heading levels, so folders nested deeper are written in one ###### heading with their path. - Flat list keeps the export's order exactly and puts the folder path before each link, which suits a long list you want to sort or filter later. - Include dates adds (added YYYY-MM-DD) after a link only when the export recorded when it was saved; Chrome and Firefox exports do. - A bookmark with no title is named after its site, such as docs.example.com, so no list item is empty. - To tidy the export first, run it through Dedupe Bookmarks or Merge Bookmarks and convert the result here. ## Frequently Asked Questions ### How do I convert my browser bookmarks to Markdown? Export them as HTML from the browser, drop the bookmarks.html file on this page and choose Download .md. Folders become Markdown headings and each bookmark becomes a - [title](url) list item under its folder, in the same order as in the browser. ### Which browsers' exports does it read? Any export in the Netscape bookmark format, which is what Chrome, Edge, Firefox, Safari and Brave write when you export bookmarks to HTML. A hand-made file with the same
and
structure also works. ### How do folders appear in the Markdown? As nested headings by default: a top-level folder is ##, the folder inside it ###, down to ######, with the links of each folder listed under its heading. Choose Flat list for one bullet list instead, where each link starts with its folder path, such as Bookmarks bar / Work. ### Can I import the result into Notion or Obsidian? Yes. Obsidian opens the .md file as a note with clickable links and a heading outline. Notion's Markdown import turns it into a page with headings and linked list items. Turn on YAML front matter if your vault uses a title property. ### Why was my file refused? It is not a bookmarks export. The page needs the Netscape bookmark structure, a
list of
entries, which every browser writes. An ordinary web page has links but not that structure; convert it with HTML to Markdown instead. An export with folders but no links is refused too, because there is nothing to write. ### Does it keep the dates and favicons? Dates are optional: turn on Include dates to add the day each bookmark was saved, when the export recorded it. Favicons are never written, because the export stores them as long base64 images that would bury the links. ### What happens to separators and empty folders? Separators are skipped and counted, because a Markdown list has no equivalent. Empty folders are left out by default; turn on Keep empty folders to write a heading for each one. ### Does the page open my bookmarks? No. Addresses are copied as text and never requested, so no site learns about your bookmarks and a link that no longer works still appears in the Markdown. ### Is my bookmarks file uploaded? Not on this page. The file is read and converted by JavaScript in your browser tab, and the Markdown is created there. A bookmarks export can reveal accounts, internal tools and reading habits, which is why it stays in the tab. The REST API and MCP tool are a separate path: a call sends the input you include to FindUtils over HTTPS, where it is processed and the result returned. FindUtils does not store that input, and logs the request without its content. ### How is this different from HTML to Markdown? HTML to Markdown converts any web page and does not know what a bookmark folder is. This page only reads bookmarks exports and keeps their folder tree as headings or folder paths. Use [HTML to Markdown](https://findutils.com/convert/html-to-markdown/) for articles and pages, and this page for a bookmarks.html file. ## Related Tools - [Bookmarks HTML to CSV](https://findutils.com/convert/bookmarks-html-to-csv/) - [CSV to Bookmarks HTML](https://findutils.com/convert/csv-to-bookmarks-html/) - [Bookmarks JSON to HTML](https://findutils.com/convert/bookmarks-json-to-html/) - [HTML to Markdown](https://findutils.com/convert/html-to-markdown/) - [OPML to Bookmarks HTML](https://findutils.com/convert/opml-to-bookmarks-html/) - [Dedupe Bookmarks](https://findutils.com/convert/dedupe-bookmarks/)