@portabletext/markdown 1.0.1 → 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 - 2025 Sanity.io
+
+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

@@ -8,6 +8,54 @@
 npm install @portabletext/markdown
 ```
 
+## Quick start
+
+**Markdown → Portable Text**
+
+```ts
+import {markdownToPortableText} from '@portabletext/markdown'
+
+const blocks = markdownToPortableText('# Hello **world**')
+```
+
+```json
+[
+  {
+    "_type": "block",
+    "_key": "f4s8k2",
+    "style": "h1",
+    "children": [
+      {"_type": "span", "_key": "a9c3x1", "text": "Hello ", "marks": []},
+      {"_type": "span", "_key": "b7d2m5", "text": "world", "marks": ["strong"]}
+    ],
+    "markDefs": []
+  }
+]
+```
+
+**Portable Text → Markdown**
+
+```ts
+import {portableTextToMarkdown} from '@portabletext/markdown'
+
+const markdown = portableTextToMarkdown([
+  {
+    _type: 'block',
+    _key: 'f4s8k2',
+    style: 'h1',
+    children: [
+      {_type: 'span', _key: 'a9c3x1', text: 'Hello ', marks: []},
+      {_type: 'span', _key: 'b7d2m5', text: 'world', marks: ['strong']},
+    ],
+    markDefs: [],
+  },
+])
+```
+
+```md
+# Hello **world**
+```
+
 ## Supported features
 
 | Feature          | Markdown → Portable Text | Portable Text → Markdown |
@@ -35,23 +83,70 @@ npm install @portabletext/markdown
 
 ### `markdownToPortableText`
 
-Converts a Markdown string to an array of Portable Text blocks.
-
 ```ts
 import {markdownToPortableText} from '@portabletext/markdown'
 
-const markdown = `
+const blocks = markdownToPortableText(`
 # Hello World
 
-This is a **bold** and *italic* text with a [link](https://example.com).
+This is **bold** and *italic* text with a [link](https://example.com).
 
 - First item
 - Second item
+`)
+```
 
-> A blockquote
-`
-
-const blocks = markdownToPortableText(markdown)
+```json
+[
+  {
+    "_type": "block",
+    "_key": "k9f2x1",
+    "style": "h1",
+    "children": [
+      {"_type": "span", "_key": "s1a2b3", "text": "Hello World", "marks": []}
+    ],
+    "markDefs": []
+  },
+  {
+    "_type": "block",
+    "_key": "m3n4p5",
+    "style": "normal",
+    "children": [
+      {"_type": "span", "_key": "s2c3d4", "text": "This is ", "marks": []},
+      {"_type": "span", "_key": "s3e4f5", "text": "bold", "marks": ["strong"]},
+      {"_type": "span", "_key": "s4g5h6", "text": " and ", "marks": []},
+      {"_type": "span", "_key": "s5i6j7", "text": "italic", "marks": ["em"]},
+      {"_type": "span", "_key": "s6k7l8", "text": " text with a ", "marks": []},
+      {"_type": "span", "_key": "s7m8n9", "text": "link", "marks": ["a1b2c3"]},
+      {"_type": "span", "_key": "s8o9p0", "text": ".", "marks": []}
+    ],
+    "markDefs": [
+      {"_type": "link", "_key": "a1b2c3", "href": "https://example.com"}
+    ]
+  },
+  {
+    "_type": "block",
+    "_key": "q1r2s3",
+    "style": "normal",
+    "listItem": "bullet",
+    "level": 1,
+    "children": [
+      {"_type": "span", "_key": "s9q0r1", "text": "First item", "marks": []}
+    ],
+    "markDefs": []
+  },
+  {
+    "_type": "block",
+    "_key": "t4u5v6",
+    "style": "normal",
+    "listItem": "bullet",
+    "level": 1,
+    "children": [
+      {"_type": "span", "_key": "s0s1t2", "text": "Second item", "marks": []}
+    ],
+    "markDefs": []
+  }
+]
 ```
 
 The conversion is driven by two concepts:
@@ -215,23 +310,60 @@ markdownToPortableText(markdown, {
 
 ### `portableTextToMarkdown`
 
-Converts an array of Portable Text blocks to a Markdown string.
-
 ```ts
 import {portableTextToMarkdown} from '@portabletext/markdown'
 
-const blocks = [
+const markdown = portableTextToMarkdown([
   {
     _type: 'block',
-    _key: 'abc123',
+    _key: 'k9f2x1',
     style: 'h1',
-    children: [{_type: 'span', _key: 'def456', text: 'Hello World', marks: []}],
+    children: [{_type: 'span', _key: 's1a2b3', text: 'Hello World', marks: []}],
     markDefs: [],
   },
-]
+  {
+    _type: 'block',
+    _key: 'm3n4p5',
+    style: 'normal',
+    children: [
+      {_type: 'span', _key: 's2c3d4', text: 'This is ', marks: []},
+      {_type: 'span', _key: 's3e4f5', text: 'bold', marks: ['strong']},
+      {_type: 'span', _key: 's4g5h6', text: ' and ', marks: []},
+      {_type: 'span', _key: 's5i6j7', text: 'italic', marks: ['em']},
+      {_type: 'span', _key: 's6k7l8', text: ' text with a ', marks: []},
+      {_type: 'span', _key: 's7m8n9', text: 'link', marks: ['a1b2c3']},
+      {_type: 'span', _key: 's8o9p0', text: '.', marks: []},
+    ],
+    markDefs: [{_type: 'link', _key: 'a1b2c3', href: 'https://example.com'}],
+  },
+  {
+    _type: 'block',
+    _key: 'q1r2s3',
+    style: 'normal',
+    listItem: 'bullet',
+    level: 1,
+    children: [{_type: 'span', _key: 's9q0r1', text: 'First item', marks: []}],
+    markDefs: [],
+  },
+  {
+    _type: 'block',
+    _key: 't4u5v6',
+    style: 'normal',
+    listItem: 'bullet',
+    level: 1,
+    children: [{_type: 'span', _key: 's0s1t2', text: 'Second item', marks: []}],
+    markDefs: [],
+  },
+])
+```
 
-const markdown = portableTextToMarkdown(blocks)
-// # Hello World
+```md
+# Hello World
+
+This is **bold** and _italic_ text with a [link](https://example.com).
+
+- First item
+- Second item
 ```
 
 The conversion is driven by **Renderers**: functions that render Portable Text elements to Markdown strings. The library includes default renderers for common types; provide your own for custom block types.
@@ -319,13 +451,6 @@ portableTextToMarkdown(blocks, {
 | `DefaultImageRenderer`          | `{src: string, alt?: string, title?: string}` | `![alt](src "title")`  |
 | `DefaultTableRenderer`          | `{rows: [...], headerRows?: number}`          | Markdown table         |
 
-**Other exports:** The library also exports mark renderers, block style renderers, and TypeScript types:
-
-- `DefaultStrongRenderer`, `DefaultEmRenderer`, `DefaultCodeRenderer`, `DefaultUnderlineRenderer`, `DefaultStrikeThroughRenderer`, `DefaultLinkRenderer`
-- `DefaultNormalRenderer`, `DefaultBlockquoteRenderer`, `DefaultH1Renderer`–`DefaultH6Renderer`
-- `DefaultListItemRenderer`, `DefaultHardBreakRenderer`, `DefaultBlockSpacingRenderer`
-- `BlockSpacingRenderer`, `PortableTextRenderers`, `PortableTextMarkRenderer`, etc.
-
 #### What renderers receive
 
 **Block renderers** (`block.*`):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portabletext/markdown",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Convert Portable Text to and from Markdown",
   "keywords": [
     "portable-text",
@@ -32,38 +32,37 @@
     "dist",
     "src"
   ],
-  "scripts": {
-    "build": "pkg-utils build --strict --check --clean",
-    "check:lint": "biome lint .",
-    "check:types": "tsc",
-    "check:types:watch": "tsc --watch",
-    "clean": "del .turbo && del dist && del node_modules",
-    "dev": "pkg-utils watch",
-    "lint:fix": "biome lint --write .",
-    "prepublishOnly": "turbo run build",
-    "test": "vitest --run",
-    "test:unit": "vitest --run --project unit",
-    "test:unit:watch": "vitest --project unit",
-    "test:watch": "vitest"
-  },
   "dependencies": {
-    "@portabletext/schema": "workspace:^",
     "@portabletext/toolkit": "^4.0.0",
-    "markdown-it": "^14.1.0"
+    "markdown-it": "^14.1.0",
+    "@portabletext/schema": "^2.0.0"
   },
   "devDependencies": {
-    "@portabletext/test": "workspace:^",
     "@portabletext/types": "^3.0.0",
     "@sanity/pkg-utils": "^10.0.0",
     "@sanity/tsconfig": "^1.0.0",
     "@types/markdown-it": "^14.1.2",
-    "typescript": "catalog:",
-    "vitest": "^4.0.9"
+    "typescript": "5.9.3",
+    "vitest": "^4.0.9",
+    "@portabletext/test": "^1.0.0"
   },
   "engines": {
     "node": ">=20.19 <22 || >=22.12"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "pkg-utils build --strict --check --clean",
+    "check:lint": "biome lint .",
+    "check:types": "tsc",
+    "check:types:watch": "tsc --watch",
+    "clean": "del .turbo && del dist && del node_modules",
+    "dev": "pkg-utils watch",
+    "lint:fix": "biome lint --write .",
+    "test": "vitest --run",
+    "test:unit": "vitest --run --project unit",
+    "test:unit:watch": "vitest --project unit",
+    "test:watch": "vitest"
   }
-}
+}