Apply suggestions from code review

Co-authored-by: Julia Rosenson <[email protected]>

README.md

@@ -9,7 +9,7 @@ Martian is a Markdown parser to convert any Markdown content to Notion API block
 uses [unified](https://github.com/unifiedjs/unified) to create a Markdown AST, then converts the AST into Notion
 objects.
 
-Designed to make using the Notion SDK and API easier.  Notion API version 0.4.4.
+Designed to make using the Notion SDK and API easier.  Notion API version 0.4.5.
 
 ### Supported Markdown Elements
 
@@ -22,20 +22,20 @@ Designed to make using the Notion SDK and API easier.  Notion API version 0.4.4.
 
 ## Unsupported Markdown Elements
 
-*tables*: Tables can be imported in an 'unsupported mode' if you add a flag to the parser.
+*tables*: Tables can be imported in an [unsupported mode](https://developers.notion.com/reference/block) if you add a flag to the parser.
 
 First, the default mode - it ignores the tables:
 
 ```ts
-const unsupported = false;
+const allowUnsupportedObjectType = false;
 const blocks: Block[] = markdownToBlocks(`
 # Table
 
 | First Header  | Second Header |
 | ------------- | ------------- |
 | Content Cell  | Content Cell  |
 | Content Cell  | Content Cell  |
-`, unsupported);
+`, allowUnsupportedObjectType);
 
 // [
 //   {
@@ -63,19 +63,19 @@ const blocks: Block[] = markdownToBlocks(`
 // ]
 ```
 
-Next, with unsupported flag = true (note I have removed the `annotations` from the returned object to make it easier to see what is going on):
+Next, with unsupported flag = true (note the `annotations` have been removed from the returned object to make it easier to see what is going on):
 
 
 ```ts
-const unsupported = true;
+const allowUnsupportedObjectType = true;
 const blocks: Block[] = markdownToBlocks(`
 # Table
 
 | First Header  | Second Header |
 | ------------- | ------------- |
 | Content Cell  | Content Cell  |
 | Content Cell  | Content Cell  |
-`, unsupported)
+`, allowUnsupportedObjectType)
 
  [
 //   {

package.json

@@ -27,7 +27,7 @@
   "author": "Richard Robinson",
   "license": "ISC",
   "dependencies": {
-    "@notionhq/client": "^0.4.4",
+    "@notionhq/client": "^0.4.5",
     "remark-gfm": "^1.0.0",
     "remark-parse": "^9.0.0",
     "unified": "^9.2.1"

src/index.ts

@@ -24,10 +24,10 @@ import gfm from 'remark-gfm';
  */
 export function markdownToBlocks(
   body: string,
-  unsupported = false
+  allowUnsupportedObjectType = false
 ): notion.Block[] {
   const root = unified().use(markdown).use(gfm).parse(body);
-  return parseBlocks(root as unknown as md.Root, unsupported);
+  return parseBlocks(root as unknown as md.Root, allowUnsupportedObjectType);
 }
 
 /**

test/integration.spec.ts

@@ -90,7 +90,7 @@ const hello = "hello";
     expect(expected).toStrictEqual(actual);
   });
 
-  it('should convert markdown to blocks - skip tables if unsupported = true', () => {
+  it('should convert markdown to blocks - include tables if unsupported = true', () => {
     const text = fs.readFileSync('test/fixtures/table.md').toString();
     const actual = markdownToBlocks(text, true);
     const expected = [