notion-to-md 2.3.2 → 2.4.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2021 Souvik Kar Mahapatra
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2021 Souvik Kar Mahapatra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,205 +1,204 @@
-<img src="https://imgur.com/WgXdz9r.png" />
-
-> 💡 For better readability and detailed instructions headover to the [wiki](https://github.com/souvikinator/notion-to-md/wiki)
-
-# Notion to Markdown
-
-Convert notion pages, block and list of blocks to markdown (supports nesting) using **[notion-sdk-js](https://github.com/makenotion/notion-sdk-js)**
-
-> **Note:** Before getting started, create [an integration and find the token](https://www.notion.so/my-integrations).
-
-[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/O5O1AFCJR)
-
-## Todo
-
-- [x] heading
-- [x] images
-- [x] quotes
-- [x] links
-- [x] bullets
-- [x] todo
-- [x] inline code
-- [x] code block
-- [x] strikethrough, underline, bold, italic
-- [x] nested blocks
-- [ ] pages inside pages/child page
-- [x] embeds, bookmarks, videos, files (converted to links)
-- [x] Simple tables
-- [x] divider
-- [x] equation block (converted to code blocks)
-- [x] convert returned markdown object to string (`toMarkdownString()`)
-- [x] typescript support
-- [ ] add tests
-
-## Install
-
-```Bash
-$ npm install notion-to-md
-```
-
-## Usage
-
-> **Note:** Details on methods can be found in [API section](https://github.com/souvikinator/notion-to-md#api)
-
-### converting markdown objects to markdown string
-
-This is how the notion page looks for this example:
-
-![Imgur](https://imgur.com/O6bKCmH.png)
-
-```js
-const { Client } = require("@notionhq/client");
-const { NotionToMarkdown } = require("notion-to-md");
-// or
-// import {NotionToMarkdown} from "notion-to-md";
-
-const notion = new Client({
-  auth: "your integration token",
-});
-
-// passing notion client to the option
-const n2m = new NotionToMarkdown({ notionClient: notion });
-
-(async () => {
-  const mdblocks = await n2m.pageToMarkdown("target_page_id");
-  const mdString = n2m.toMarkdownString(mdblocks);
-
-  //writing to file
-  fs.writeFile("test.md", mdString, (err) => {
-    console.log(err);
-  });
-})();
-```
-
-**Output:**
-
-![output](https://imgur.com/XrUYrZ0.png)
-
-### converting page to markdown object
-
-Example notion page:
-
-![Imgur](https://imgur.com/9iqRpBl.png)
-
-```js
-const { Client } = require("@notionhq/client");
-const { NotionToMarkdown } = require("notion-to-md");
-
-const notion = new Client({
-  auth: "your integration token",
-});
-
-// passing notion client to the option
-const n2m = new NotionToMarkdown({ notionClient: notion });
-
-(async () => {
-  // notice second argument, totalPage.
-  const x = await n2m.pageToMarkdown("target_page_id", 2);
-  console.log(x);
-})();
-```
-
-**Output:**
-
-```json
-[
-  {
-    "parent": "# heading 1",
-    "children": []
-  },
-  {
-    "parent": "- bullet 1",
-    "children": [
-      {
-        "parent": "- bullet 1.1",
-        "children": []
-      },
-      {
-        "parent": "- bullet 1.2",
-        "children": []
-      }
-    ]
-  },
-  {
-    "parent": "- bullet 2",
-    "children": []
-  },
-  {
-    "parent": "- [ ] check box 1",
-    "children": [
-      {
-        "parent": "- [x] check box 1.2",
-        "children": []
-      },
-      {
-        "parent": "- [ ] check box 1.3",
-        "children": []
-      }
-    ]
-  },
-  {
-    "parent": "- [ ] checkbox 2",
-    "children": []
-  }
-]
-```
-
-### converting list of blocks to markdown object
-
-same notion page as before
-
-```js
-const { Client } = require("@notionhq/client");
-const { NotionToMarkdown } = require("notion-to-md");
-
-const notion = new Client({
-  auth: "your integration token",
-});
-
-// passing notion client to the option
-const n2m = new NotionToMarkdown({ notionClient: notion });
-
-(async () => {
-  // get all blocks in the page
-  const { results } = await notion.blocks.children.list({
-    block_id,
-  });
-
-  //convert to markdown
-  const x = await n2m.blocksToMarkdown(results);
-  console.log(x);
-})();
-```
-
-**Output**: same as before
-
-### Converting a single block to markdown string
-
-- only takes a single notion block and returns corresponding markdown string
-- nesting is ignored
-- depends on @notionhq/client
-
-```js
-const { NotionToMarkdown } = require("notion-to-md");
-
-// passing notion client to the option
-const n2m = new NotionToMarkdown({ notionClient: notion });
-
-const result = n2m.blockToMarkdown(block);
-console.log(result);
-```
-
-**result**:
-
-```
-![image](https://media.giphy.com/media/Ju7l5y9osyymQ/giphy.gif)
-```
-
-## Contribution
-
-Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
-Please make sure to update tests as appropriate.
-
-## License
-
-[MIT](https://choosealicense.com/licenses/mit/)
+<img src="https://imgur.com/WgXdz9r.png" />
+
+> 💡 For better readability and detailed instructions headover to the [wiki](https://github.com/souvikinator/notion-to-md/wiki)
+
+# Notion to Markdown
+
+Convert notion pages, block and list of blocks to markdown (supports nesting) using **[notion-sdk-js](https://github.com/makenotion/notion-sdk-js)**
+
+> **Note:** Before getting started, create [an integration and find the token](https://www.notion.so/my-integrations).
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/O5O1AFCJR)
+
+## Todo
+
+- [x] heading
+- [x] images
+- [x] quotes
+- [x] links
+- [x] bullets
+- [x] todo
+- [x] inline code
+- [x] code block
+- [x] strikethrough, underline, bold, italic
+- [x] nested blocks
+- [x] embeds, bookmarks, videos, files (converted to links)
+- [x] Simple tables
+- [x] divider
+- [x] equation block (converted to code blocks)
+- [x] convert returned markdown object to string (`toMarkdownString()`)
+- [x] typescript support
+- [ ] add tests
+
+## Install
+
+```Bash
+$ npm install notion-to-md
+```
+
+## Usage
+
+> **Note:** Details on methods can be found in [API section](https://github.com/souvikinator/notion-to-md#api)
+
+### converting markdown objects to markdown string
+
+This is how the notion page looks for this example:
+
+![Imgur](https://imgur.com/O6bKCmH.png)
+
+```js
+const { Client } = require("@notionhq/client");
+const { NotionToMarkdown } = require("notion-to-md");
+// or
+// import {NotionToMarkdown} from "notion-to-md";
+
+const notion = new Client({
+  auth: "your integration token",
+});
+
+// passing notion client to the option
+const n2m = new NotionToMarkdown({ notionClient: notion });
+
+(async () => {
+  const mdblocks = await n2m.pageToMarkdown("target_page_id");
+  const mdString = n2m.toMarkdownString(mdblocks);
+
+  //writing to file
+  fs.writeFile("test.md", mdString, (err) => {
+    console.log(err);
+  });
+})();
+```
+
+**Output:**
+
+![output](https://imgur.com/XrUYrZ0.png)
+
+### converting page to markdown object
+
+Example notion page:
+
+![Imgur](https://imgur.com/9iqRpBl.png)
+
+```js
+const { Client } = require("@notionhq/client");
+const { NotionToMarkdown } = require("notion-to-md");
+
+const notion = new Client({
+  auth: "your integration token",
+});
+
+// passing notion client to the option
+const n2m = new NotionToMarkdown({ notionClient: notion });
+
+(async () => {
+  // notice second argument, totalPage.
+  const x = await n2m.pageToMarkdown("target_page_id", 2);
+  console.log(x);
+})();
+```
+
+**Output:**
+
+```json
+[
+  {
+    "parent": "# heading 1",
+    "children": []
+  },
+  {
+    "parent": "- bullet 1",
+    "children": [
+      {
+        "parent": "- bullet 1.1",
+        "children": []
+      },
+      {
+        "parent": "- bullet 1.2",
+        "children": []
+      }
+    ]
+  },
+  {
+    "parent": "- bullet 2",
+    "children": []
+  },
+  {
+    "parent": "- [ ] check box 1",
+    "children": [
+      {
+        "parent": "- [x] check box 1.2",
+        "children": []
+      },
+      {
+        "parent": "- [ ] check box 1.3",
+        "children": []
+      }
+    ]
+  },
+  {
+    "parent": "- [ ] checkbox 2",
+    "children": []
+  }
+]
+```
+
+### converting list of blocks to markdown object
+
+same notion page as before
+
+```js
+const { Client } = require("@notionhq/client");
+const { NotionToMarkdown } = require("notion-to-md");
+
+const notion = new Client({
+  auth: "your integration token",
+});
+
+// passing notion client to the option
+const n2m = new NotionToMarkdown({ notionClient: notion });
+
+(async () => {
+  // get all blocks in the page
+  const { results } = await notion.blocks.children.list({
+    block_id,
+  });
+
+  //convert to markdown
+  const x = await n2m.blocksToMarkdown(results);
+  console.log(x);
+})();
+```
+
+**Output**: same as before
+
+### Converting a single block to markdown string
+
+- only takes a single notion block and returns corresponding markdown string
+- nesting is ignored
+- depends on @notionhq/client
+
+```js
+const { NotionToMarkdown } = require("notion-to-md");
+
+// passing notion client to the option
+const n2m = new NotionToMarkdown({ notionClient: notion });
+
+const result = n2m.blockToMarkdown(block);
+console.log(result);
+```
+
+**result**:
+
+```
+![image](https://media.giphy.com/media/Ju7l5y9osyymQ/giphy.gif)
+```
+
+## Contribution
+
+Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
+Please make sure to update tests as appropriate.
+
+## License
+
+[MIT](https://choosealicense.com/licenses/mit/)

package/build/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./notion-to-md";
+export * from "./notion-to-md";
 //# sourceMappingURL=index.d.ts.map

package/build/index.js

@@ -1,18 +1,18 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./notion-to-md"), exports);
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./notion-to-md"), exports);
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B","sourcesContent":["export * from \"./notion-to-md\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B","sourcesContent":["export * from \"./notion-to-md\";\r\n"]}

package/build/notion-to-md.d.ts

@@ -1,44 +1,44 @@
-import { Annotations, ListBlockChildrenResponseResult, ListBlockChildrenResponseResults, MdBlock, NotionToMarkdownOptions } from "./types";
-/**
- * Converts a Notion page to Markdown.
- */
-export declare class NotionToMarkdown {
-    private notionClient;
-    constructor(options: NotionToMarkdownOptions);
-    /**
-     * Converts Markdown Blocks to string
-     * @param {MdBlock[]} mdBlocks - Array of markdown blocks
-     * @param {number} nestingLevel - Defines max depth of nesting
-     * @returns {string} - Returns markdown string
-     */
-    toMarkdownString(mdBlocks?: MdBlock[], nestingLevel?: number): string;
-    /**
-     * Retrieves Notion Blocks based on ID and converts them to Markdown Blocks
-     * @param {string} id - notion page id (not database id)
-     * @param {number} totalPage - Retrieve block children request number, page_size Maximum = totalPage * 100 (Default=null)
-     * @returns {Promise<MdBlock[]>} - List of markdown blocks
-     */
-    pageToMarkdown(id: string, totalPage?: number | null): Promise<MdBlock[]>;
-    /**
-     * Converts list of Notion Blocks to Markdown Blocks
-     * @param {ListBlockChildrenResponseResults | undefined} blocks - List of notion blocks
-     * @param {number} totalPage - Retrieve block children request number, page_size Maximum = totalPage * 100
-     * @param {MdBlock[]} mdBlocks - Defines max depth of nesting
-     * @returns {Promise<MdBlock[]>} - Array of markdown blocks with their children
-     */
-    blocksToMarkdown(blocks?: ListBlockChildrenResponseResults, totalPage?: number | null, mdBlocks?: MdBlock[]): Promise<MdBlock[]>;
-    /**
-     * Converts a Notion Block to a Markdown Block
-     * @param {ListBlockChildrenResponseResult} block - single notion block
-     * @returns {string} corresponding markdown string of the passed block
-     */
-    blockToMarkdown(block: ListBlockChildrenResponseResult): Promise<string>;
-    /**
-     * Annoate text using provided annotations
-     * @param {string} text - String to be annotated
-     * @param {Annotations} annotations - Annotation object of a notion block
-     * @returns {string} - Annotated text
-     */
-    annotatePlainText(text: string, annotations: Annotations): string;
-}
+import { Annotations, ListBlockChildrenResponseResult, ListBlockChildrenResponseResults, MdBlock, NotionToMarkdownOptions } from "./types";
+/**
+ * Converts a Notion page to Markdown.
+ */
+export declare class NotionToMarkdown {
+    private notionClient;
+    constructor(options: NotionToMarkdownOptions);
+    /**
+     * Converts Markdown Blocks to string
+     * @param {MdBlock[]} mdBlocks - Array of markdown blocks
+     * @param {number} nestingLevel - Defines max depth of nesting
+     * @returns {string} - Returns markdown string
+     */
+    toMarkdownString(mdBlocks?: MdBlock[], nestingLevel?: number): string;
+    /**
+     * Retrieves Notion Blocks based on ID and converts them to Markdown Blocks
+     * @param {string} id - notion page id (not database id)
+     * @param {number} totalPage - Retrieve block children request number, page_size Maximum = totalPage * 100 (Default=null)
+     * @returns {Promise<MdBlock[]>} - List of markdown blocks
+     */
+    pageToMarkdown(id: string, totalPage?: number | null): Promise<MdBlock[]>;
+    /**
+     * Converts list of Notion Blocks to Markdown Blocks
+     * @param {ListBlockChildrenResponseResults | undefined} blocks - List of notion blocks
+     * @param {number} totalPage - Retrieve block children request number, page_size Maximum = totalPage * 100
+     * @param {MdBlock[]} mdBlocks - Defines max depth of nesting
+     * @returns {Promise<MdBlock[]>} - Array of markdown blocks with their children
+     */
+    blocksToMarkdown(blocks?: ListBlockChildrenResponseResults, totalPage?: number | null, mdBlocks?: MdBlock[]): Promise<MdBlock[]>;
+    /**
+     * Converts a Notion Block to a Markdown Block
+     * @param {ListBlockChildrenResponseResult} block - single notion block
+     * @returns {string} corresponding markdown string of the passed block
+     */
+    blockToMarkdown(block: ListBlockChildrenResponseResult): Promise<string>;
+    /**
+     * Annoate text using provided annotations
+     * @param {string} text - String to be annotated
+     * @param {Annotations} annotations - Annotation object of a notion block
+     * @returns {string} - Annotated text
+     */
+    annotatePlainText(text: string, annotations: Annotations): string;
+}
 //# sourceMappingURL=notion-to-md.d.ts.map

package/build/notion-to-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notion-to-md.d.ts","sourceRoot":"","sources":["../src/notion-to-md.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,+BAA+B,EAC/B,gCAAgC,EAChC,OAAO,EAEP,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,uBAAuB;IAI5C;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,GAAE,OAAO,EAAO,EAAE,YAAY,GAAE,MAAU,GAAG,MAAM;IAe5E;;;;;OAKG;IACG,cAAc,CAClB,EAAE,EAAE,MAAM,EACV,SAAS,GAAE,MAAM,GAAG,IAAW,GAC9B,OAAO,CAAC,OAAO,EAAE,CAAC;IAarB;;;;;;OAMG;IACG,gBAAgB,CACpB,MAAM,CAAC,EAAE,gCAAgC,EACzC,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,QAAQ,GAAE,OAAO,EAAO,GACvB,OAAO,CAAC,OAAO,EAAE,CAAC;IAsCrB;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE,+BAA+B;IA+L5D;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM;CAsBlE"}
+{"version":3,"file":"notion-to-md.d.ts","sourceRoot":"","sources":["../src/notion-to-md.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,+BAA+B,EAC/B,gCAAgC,EAChC,OAAO,EAEP,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,uBAAuB;IAI5C;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,GAAE,OAAO,EAAO,EAAE,YAAY,GAAE,MAAU,GAAG,MAAM;IAe5E;;;;;OAKG;IACG,cAAc,CAClB,EAAE,EAAE,MAAM,EACV,SAAS,GAAE,MAAM,GAAG,IAAW,GAC9B,OAAO,CAAC,OAAO,EAAE,CAAC;IAarB;;;;;;OAMG;IACG,gBAAgB,CACpB,MAAM,CAAC,EAAE,gCAAgC,EACzC,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,QAAQ,GAAE,OAAO,EAAO,GACvB,OAAO,CAAC,OAAO,EAAE,CAAC;IA0CrB;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE,+BAA+B;IAmR5D;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM;CAsBlE"}