@headwall/markdown-to-blocks 1.1.1 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +14 -1
- package/README.md +2 -0
- package/dist/{chunk-7B766ZGD.js → chunk-CHMDS2SX.js} +67 -6
- package/dist/chunk-CHMDS2SX.js.map +1 -0
- package/dist/cli.js +6 -2
- package/dist/cli.js.map +1 -1
- package/dist/index.d.ts +7 -0
- package/dist/index.js +1 -1
- package/package.json +5 -2
- package/dist/chunk-7B766ZGD.js.map +0 -1
package/dist/cli.js
CHANGED
|
@@ -4,7 +4,7 @@ const require = __md2b_cr(import.meta.url);
|
|
|
4
4
|
import {
|
|
5
5
|
markdownToBlocks,
|
|
6
6
|
parseMarkdownDocument
|
|
7
|
-
} from "./chunk-
|
|
7
|
+
} from "./chunk-CHMDS2SX.js";
|
|
8
8
|
|
|
9
9
|
// src/cli.ts
|
|
10
10
|
import { readFileSync, writeFileSync } from "fs";
|
|
@@ -21,6 +21,7 @@ Options:
|
|
|
21
21
|
--frontmatter Emit JSON { frontmatter, blocks } instead of markup
|
|
22
22
|
--heading-shift <n> Shift all heading levels by n (default 0)
|
|
23
23
|
--min-heading-level <n> Clamp heading levels to [n, 6] (default 2)
|
|
24
|
+
--heading-anchors Add an id/anchor to each heading from its text
|
|
24
25
|
--code-language <mode> 'drop' (default) or 'class' (emit language-xxx)
|
|
25
26
|
--unsupported <mode> 'html' (default) or 'skip'
|
|
26
27
|
--no-gfm Disable GFM (tables, strikethrough, autolinks)
|
|
@@ -55,6 +56,9 @@ function parseArgs(argv) {
|
|
|
55
56
|
case "--min-heading-level":
|
|
56
57
|
args.options.minHeadingLevel = Number(argv[++i]);
|
|
57
58
|
break;
|
|
59
|
+
case "--heading-anchors":
|
|
60
|
+
args.options.headingAnchors = true;
|
|
61
|
+
break;
|
|
58
62
|
case "--code-language":
|
|
59
63
|
args.options.codeLanguage = argv[++i];
|
|
60
64
|
break;
|
|
@@ -95,7 +99,7 @@ function run(argv) {
|
|
|
95
99
|
return 0;
|
|
96
100
|
}
|
|
97
101
|
if (args.version) {
|
|
98
|
-
process.stdout.write(`${"1.
|
|
102
|
+
process.stdout.write(`${"1.2.0"}
|
|
99
103
|
`);
|
|
100
104
|
return 0;
|
|
101
105
|
}
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync, writeFileSync } from \"node:fs\";\nimport { markdownToBlocks } from \"./convert.js\";\nimport { parseMarkdownDocument } from \"./document.js\";\nimport type { ConvertOptions } from \"./types.js\";\n\nconst HELP = `md2blocks — convert Markdown to WordPress/Gutenberg block markup\n\nUsage:\n md2blocks -i <file.md> [-o <out.html>]\n md2blocks <file.md>\n cat doc.md | md2blocks -\n\nOptions:\n -i, --input <file> Input Markdown file (use \"-\" or omit for stdin)\n -o, --output <file> Output file (default: stdout)\n --frontmatter Emit JSON { frontmatter, blocks } instead of markup\n --heading-shift <n> Shift all heading levels by n (default 0)\n --min-heading-level <n> Clamp heading levels to [n, 6] (default 2)\n --code-language <mode> 'drop' (default) or 'class' (emit language-xxx)\n --unsupported <mode> 'html' (default) or 'skip'\n --no-gfm Disable GFM (tables, strikethrough, autolinks)\n -h, --help Show this help\n -v, --version Show version\n`;\n\ninterface CliArgs {\n input?: string;\n output?: string;\n frontmatter: boolean;\n help: boolean;\n version: boolean;\n options: ConvertOptions;\n}\n\nfunction parseArgs(argv: string[]): CliArgs {\n const args: CliArgs = {\n frontmatter: false,\n help: false,\n version: false,\n options: {},\n };\n let positional: string | undefined;\n\n for (let i = 0; i < argv.length; i++) {\n const arg = argv[i];\n switch (arg) {\n case \"-i\":\n case \"--input\":\n args.input = argv[++i];\n break;\n case \"-o\":\n case \"--output\":\n args.output = argv[++i];\n break;\n case \"--frontmatter\":\n args.frontmatter = true;\n break;\n case \"--heading-shift\":\n args.options.headingShift = Number(argv[++i]);\n break;\n case \"--min-heading-level\":\n args.options.minHeadingLevel = Number(argv[++i]);\n break;\n case \"--code-language\":\n args.options.codeLanguage = argv[++i] as ConvertOptions[\"codeLanguage\"];\n break;\n case \"--unsupported\":\n args.options.unsupported = argv[++i] as ConvertOptions[\"unsupported\"];\n break;\n case \"--no-gfm\":\n args.options.gfm = false;\n break;\n case \"-h\":\n case \"--help\":\n args.help = true;\n break;\n case \"-v\":\n case \"--version\":\n args.version = true;\n break;\n default:\n if (arg != null && !arg.startsWith(\"-\") && positional == null) {\n positional = arg;\n }\n break;\n }\n }\n\n // A bare positional file acts as input when -i wasn't given.\n if (args.input == null && positional != null) {\n args.input = positional;\n }\n return args;\n}\n\nfunction readInput(input: string | undefined): string {\n // \"-\" or no input → read stdin; otherwise read the named file.\n const source = input == null || input === \"-\" ? 0 : input;\n return readFileSync(source, \"utf8\");\n}\n\nfunction run(argv: string[]): number {\n const args = parseArgs(argv);\n\n if (args.help) {\n process.stdout.write(HELP);\n return 0;\n }\n if (args.version) {\n process.stdout.write(`${VERSION}\\n`);\n return 0;\n }\n\n // Reading stdin with nothing piped in would hang forever on a TTY — fail fast\n // with a usage hint instead.\n const wantsStdin = args.input == null || args.input === \"-\";\n if (wantsStdin && process.stdin.isTTY) {\n process.stderr.write(\n \"md2blocks: no input provided. Pass -i <file>, give a filename, or pipe Markdown via stdin.\\n\\n\",\n );\n process.stderr.write(HELP);\n return 1;\n }\n\n const markdown = readInput(args.input);\n const result = args.frontmatter\n ? `${JSON.stringify(parseMarkdownDocument(markdown, args.options), null, 2)}\\n`\n : `${markdownToBlocks(markdown, args.options)}\\n`;\n\n if (args.output != null) {\n writeFileSync(args.output, result);\n } else {\n process.stdout.write(result);\n }\n return 0;\n}\n\n// Replaced at build time by tsup `define`; falls back for ts-node/dev runs.\ndeclare const VERSION: string;\n\ntry {\n process.exit(run(process.argv.slice(2)));\n} catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n process.stderr.write(`md2blocks: ${message}\\n`);\n process.exit(1);\n}\n"],"mappings":";;;;;;;;;AACA,SAAS,cAAc,qBAAqB;AAK5C,IAAM,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;
|
|
1
|
+
{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync, writeFileSync } from \"node:fs\";\nimport { markdownToBlocks } from \"./convert.js\";\nimport { parseMarkdownDocument } from \"./document.js\";\nimport type { ConvertOptions } from \"./types.js\";\n\nconst HELP = `md2blocks — convert Markdown to WordPress/Gutenberg block markup\n\nUsage:\n md2blocks -i <file.md> [-o <out.html>]\n md2blocks <file.md>\n cat doc.md | md2blocks -\n\nOptions:\n -i, --input <file> Input Markdown file (use \"-\" or omit for stdin)\n -o, --output <file> Output file (default: stdout)\n --frontmatter Emit JSON { frontmatter, blocks } instead of markup\n --heading-shift <n> Shift all heading levels by n (default 0)\n --min-heading-level <n> Clamp heading levels to [n, 6] (default 2)\n --heading-anchors Add an id/anchor to each heading from its text\n --code-language <mode> 'drop' (default) or 'class' (emit language-xxx)\n --unsupported <mode> 'html' (default) or 'skip'\n --no-gfm Disable GFM (tables, strikethrough, autolinks)\n -h, --help Show this help\n -v, --version Show version\n`;\n\ninterface CliArgs {\n input?: string;\n output?: string;\n frontmatter: boolean;\n help: boolean;\n version: boolean;\n options: ConvertOptions;\n}\n\nfunction parseArgs(argv: string[]): CliArgs {\n const args: CliArgs = {\n frontmatter: false,\n help: false,\n version: false,\n options: {},\n };\n let positional: string | undefined;\n\n for (let i = 0; i < argv.length; i++) {\n const arg = argv[i];\n switch (arg) {\n case \"-i\":\n case \"--input\":\n args.input = argv[++i];\n break;\n case \"-o\":\n case \"--output\":\n args.output = argv[++i];\n break;\n case \"--frontmatter\":\n args.frontmatter = true;\n break;\n case \"--heading-shift\":\n args.options.headingShift = Number(argv[++i]);\n break;\n case \"--min-heading-level\":\n args.options.minHeadingLevel = Number(argv[++i]);\n break;\n case \"--heading-anchors\":\n args.options.headingAnchors = true;\n break;\n case \"--code-language\":\n args.options.codeLanguage = argv[++i] as ConvertOptions[\"codeLanguage\"];\n break;\n case \"--unsupported\":\n args.options.unsupported = argv[++i] as ConvertOptions[\"unsupported\"];\n break;\n case \"--no-gfm\":\n args.options.gfm = false;\n break;\n case \"-h\":\n case \"--help\":\n args.help = true;\n break;\n case \"-v\":\n case \"--version\":\n args.version = true;\n break;\n default:\n if (arg != null && !arg.startsWith(\"-\") && positional == null) {\n positional = arg;\n }\n break;\n }\n }\n\n // A bare positional file acts as input when -i wasn't given.\n if (args.input == null && positional != null) {\n args.input = positional;\n }\n return args;\n}\n\nfunction readInput(input: string | undefined): string {\n // \"-\" or no input → read stdin; otherwise read the named file.\n const source = input == null || input === \"-\" ? 0 : input;\n return readFileSync(source, \"utf8\");\n}\n\nfunction run(argv: string[]): number {\n const args = parseArgs(argv);\n\n if (args.help) {\n process.stdout.write(HELP);\n return 0;\n }\n if (args.version) {\n process.stdout.write(`${VERSION}\\n`);\n return 0;\n }\n\n // Reading stdin with nothing piped in would hang forever on a TTY — fail fast\n // with a usage hint instead.\n const wantsStdin = args.input == null || args.input === \"-\";\n if (wantsStdin && process.stdin.isTTY) {\n process.stderr.write(\n \"md2blocks: no input provided. Pass -i <file>, give a filename, or pipe Markdown via stdin.\\n\\n\",\n );\n process.stderr.write(HELP);\n return 1;\n }\n\n const markdown = readInput(args.input);\n const result = args.frontmatter\n ? `${JSON.stringify(parseMarkdownDocument(markdown, args.options), null, 2)}\\n`\n : `${markdownToBlocks(markdown, args.options)}\\n`;\n\n if (args.output != null) {\n writeFileSync(args.output, result);\n } else {\n process.stdout.write(result);\n }\n return 0;\n}\n\n// Replaced at build time by tsup `define`; falls back for ts-node/dev runs.\ndeclare const VERSION: string;\n\ntry {\n process.exit(run(process.argv.slice(2)));\n} catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n process.stderr.write(`md2blocks: ${message}\\n`);\n process.exit(1);\n}\n"],"mappings":"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","names":[]}
|
package/dist/index.d.ts
CHANGED
|
@@ -16,6 +16,13 @@ interface ConvertOptions {
|
|
|
16
16
|
headingShift?: number;
|
|
17
17
|
/** Clamp resulting heading levels into [min, 6]. Default min = 2 (avoid body h1). */
|
|
18
18
|
minHeadingLevel?: number;
|
|
19
|
+
/**
|
|
20
|
+
* Derive an `id` (WordPress `anchor` attribute) for every heading from its
|
|
21
|
+
* text, so in-page anchor links work. GitHub-style slugs, de-duplicated per
|
|
22
|
+
* document (`overview`, `overview-1`, …). Default false. A heading that slugs
|
|
23
|
+
* to nothing (only punctuation/emoji) gets no `id`.
|
|
24
|
+
*/
|
|
25
|
+
headingAnchors?: boolean;
|
|
19
26
|
/**
|
|
20
27
|
* Resolve a Markdown image to a WordPress image. Return undefined to emit an
|
|
21
28
|
* "external" image block (no attachment id). The agent supplies this after
|
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@headwall/markdown-to-blocks",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "Convert Markdown into serialised WordPress/Gutenberg block markup (core blocks, with <!-- wp:... --> delimiters).",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"markdown",
|
|
@@ -41,6 +41,9 @@
|
|
|
41
41
|
"CHANGELOG.md"
|
|
42
42
|
],
|
|
43
43
|
"sideEffects": false,
|
|
44
|
+
"overrides": {
|
|
45
|
+
"esbuild": "^0.28.1"
|
|
46
|
+
},
|
|
44
47
|
"scripts": {
|
|
45
48
|
"build": "tsup",
|
|
46
49
|
"dev": "tsup --watch",
|
|
@@ -62,7 +65,7 @@
|
|
|
62
65
|
"typescript": "^5.7.2",
|
|
63
66
|
"unified": "^11.0.5",
|
|
64
67
|
"unist-util-visit": "^5.0.0",
|
|
65
|
-
"vitest": "^
|
|
68
|
+
"vitest": "^4.1.9",
|
|
66
69
|
"yaml": "^2.6.1"
|
|
67
70
|
}
|
|
68
71
|
}
|