# souvikinator/notion-to-md

Convert Notion pages, blocks, or entire lists into any format: Markdown, MDX, JSX, HTML, LaTeX, and more. A powerful Notion conversion engine that lets you write once in Notion and publish seamlessly anywhere, in any format. Compatible with your favorite CMS, workflow, static site generator, and beyond.

Repository: https://github.com/souvikinator/notion-to-md
Canonical: https://ross.abutalabs.com/products/notion-to-md
Homepage: https://notionconvert.com/docs/v4
Language: TypeScript
License: MIT
License Family: permissive
Topics: notion, notion-api, notion-database, md, markdown, notion-to-md, notion2md, notion-client, notion-markdown, nodejs, hacktoberfest, exporter, notion-export, notion-convert, notion-exporter, notion-to-anything, notion-to-html
Last push: 2026-01-27T20:30:25+00:00

## Health v2 (maintenance only)
Score: 63/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 64, release rhythm 40, longevity 100
- inputs: {"age_days": 1733, "days_push": 218, "days_rel": 478, "gap_med": 13, "n_releases_24m": 8}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1731, forks 124 (observed 2026-08-28T04:05:28.723875+00:00)

## What it is
A Node.js/TypeScript library that converts Notion pages, blocks, and databases into Markdown, MDX, HTML, LaTeX, and other formats via the Notion API. Version 4 features a plugin-based architecture with customizable renderers, exporters, and media handling strategies.

## Use cases
- convert notion pages to markdown
- export notion content for a static site generator
- turn notion database into mdx with frontmatter
- publish notion content to a cms
- convert notion blocks to html or latex
- sync notion docs into a documentation site

## When to choose
- you author content in Notion and publish elsewhere
- you need customizable output formats via renderer/exporter plugins
- you want programmatic conversion in a Node.js pipeline

## When to avoid
- you need a one-off manual export (Notion's built-in export may suffice)
- you don't use Node.js/TypeScript
- you need a GUI tool rather than a library

## Facets
- artifact type: library
- maturity: active
- function: markdown, parser, plugin-system, sdk
- domain: cms, documentation, web-development, developer-tools
- platform: cli
- tags: notion, notion-api, markdown-conversion, mdx, content-exporter, static-site-generator, nodejs

## Member repositories
- souvikinator/notion-to-md (main) score 63

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:28.723875+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:31:44.156806+00:00, confidence not recorded.
  - readme: https://github.com/souvikinator/notion-to-md (fetched 2026-08-28T04:05:28.723875+00:00, sha d6c8313394ab)
  - homepage: https://notionconvert.com/docs/v4 (fetched 2026-08-29T11:09:06.249875+00:00, sha 89b6e2a547e7)
  - site_page: https://notionconvert.com/docs (fetched 2026-08-29T11:09:06.259688+00:00, sha 5821b031368e)
  - site_page: https://notionconvert.com/docs/v4/getting-started (fetched 2026-08-29T11:09:06.261888+00:00, sha 56b09dabc753)
  - site_page: https://notionconvert.com/docs/v4/guides (fetched 2026-08-29T11:09:06.264452+00:00, sha 71e2cbbe8044)
  - site_page: https://notionconvert.com/docs/v4/guides/how-to-modify-renderer-plugin (fetched 2026-08-29T11:09:06.266534+00:00, sha 5a4475ecc83d)
  - site_page: https://notionconvert.com/docs/v4/guides/how-to-handle-blocks-with-children (fetched 2026-08-29T11:09:06.268599+00:00, sha 6d8ee781340f)
  - site_page: https://notionconvert.com/docs/v4/guides/how-to-create-renderer-from-scratch (fetched 2026-08-29T11:09:06.270579+00:00, sha 323ed43522dc)
  - site_page: https://notionconvert.com/docs/v4/guides/how-to-generate-references-for-page (fetched 2026-08-29T11:09:06.272461+00:00, sha c0e1671916e6)
  - site_page: https://notionconvert.com/docs/v4/guides/how-to-modify-notion-database (fetched 2026-08-29T11:09:06.274310+00:00, sha da3d782467b8)
- Data as of 2026-08-30T08:39:29.467469+00:00.