md2xhs 1.0.0

package/dist/file-utils.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFile = isFile;
+exports.isDirectory = isDirectory;
+exports.readMarkdownFile = readMarkdownFile;
+exports.getMarkdownFiles = getMarkdownFiles;
+exports.generateOutputPath = generateOutputPath;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+/**
+ * 判断路径是否为文件
+ */
+async function isFile(path) {
+    try {
+        const stats = await (0, promises_1.stat)(path);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 判断路径是否为目录
+ */
+async function isDirectory(path) {
+    try {
+        const stats = await (0, promises_1.stat)(path);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 读取 Markdown 文件内容
+ */
+async function readMarkdownFile(filePath) {
+    const content = await (0, promises_1.readFile)(filePath, 'utf-8');
+    return content;
+}
+/**
+ * 获取目录中所有的 Markdown 文件
+ */
+async function getMarkdownFiles(dirPath, recursive = false) {
+    const files = [];
+    async function scan(dir) {
+        const entries = await (0, promises_1.readdir)(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = (0, path_1.join)(dir, entry.name);
+            if (entry.isFile() && (0, path_1.extname)(entry.name).toLowerCase() === '.md') {
+                files.push(fullPath);
+            }
+            else if (entry.isDirectory() && recursive) {
+                await scan(fullPath);
+            }
+        }
+    }
+    await scan(dirPath);
+    return files;
+}
+/**
+ * 生成输出文件路径
+ * 例如: './docs/README.md' -> './docs/README.png'
+ */
+function generateOutputPath(inputPath, outputDir) {
+    const baseName = (0, path_1.basename)(inputPath, (0, path_1.extname)(inputPath));
+    const dir = outputDir || (0, path_1.dirname)(inputPath);
+    return (0, path_1.join)(dir, `${baseName}.png`);
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types';
+export * from './converter';
+export * from './styles';
+export * from './file-utils';
+export { Md2ImageConverter as default } from './converter';

package/dist/index.js

@@ -0,0 +1,24 @@
+"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 });
+exports.default = void 0;
+__exportStar(require("./types"), exports);
+__exportStar(require("./converter"), exports);
+__exportStar(require("./styles"), exports);
+__exportStar(require("./file-utils"), exports);
+// 默认导出
+var converter_1 = require("./converter");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return converter_1.Md2ImageConverter; } });

package/dist/styles.d.ts

@@ -0,0 +1,21 @@
+import { BackgroundPreset, CustomBackground } from './types';
+/**
+ * CSS 变量定义
+ */
+export declare const CSS_VARIABLES = "\n:root {\n    --primary-color: #6366f1;\n    --primary-hover: #4f46e5;\n    --secondary-color: #8b5cf6;\n    --text-primary: #1e293b;\n    --text-secondary: #334155;\n    --text-muted: #64748b;\n    --text-light: #475569;\n    --background-light: #f8fafc;\n    --background-gray: #f1f5f9;\n    --border-color: #e2e8f0;\n    --border-light: #cbd5e1;\n    --shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.1);\n    --shadow-md: 0 4px 12px rgba(0, 0, 0, 0.1);\n    --shadow-lg: 0 8px 32px rgba(0, 0, 0, 0.1);\n    --border-radius: 8px;\n    --border-radius-lg: 12px;\n    --font-mono: 'SF Mono', 'Monaco', 'Inconsolata', 'Roboto Mono', monospace;\n}\n";
+/**
+ * 背景预设样式
+ */
+export declare const BACKGROUND_PRESETS: Record<BackgroundPreset, string>;
+/**
+ * 完整样式表
+ */
+export declare const FULL_STYLES = "\n\n:root {\n    --primary-color: #6366f1;\n    --primary-hover: #4f46e5;\n    --secondary-color: #8b5cf6;\n    --text-primary: #1e293b;\n    --text-secondary: #334155;\n    --text-muted: #64748b;\n    --text-light: #475569;\n    --background-light: #f8fafc;\n    --background-gray: #f1f5f9;\n    --border-color: #e2e8f0;\n    --border-light: #cbd5e1;\n    --shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.1);\n    --shadow-md: 0 4px 12px rgba(0, 0, 0, 0.1);\n    --shadow-lg: 0 8px 32px rgba(0, 0, 0, 0.1);\n    --border-radius: 8px;\n    --border-radius-lg: 12px;\n    --font-mono: 'SF Mono', 'Monaco', 'Inconsolata', 'Roboto Mono', monospace;\n}\n\n\n* {\n    margin: 0;\n    padding: 0;\n    box-sizing: border-box;\n}\n\nbody {\n    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;\n    background: var(--background-light);\n    color: var(--text-secondary);\n    line-height: 1.6;\n}\n\n.markdown-poster {\n    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);\n    border-radius: 0;\n    padding: 40px;\n    margin: 20px;\n    box-shadow: 0 20px 40px rgba(0, 0, 0, 0.1);\n    width: 640px;\n    min-height: 600px;\n    position: relative;\n    overflow: hidden;\n    box-sizing: border-box;\n}\n\n.markdown-poster::before {\n    content: '';\n    position: absolute;\n    top: 0;\n    left: 0;\n    right: 0;\n    bottom: 0;\n    background: rgba(255, 255, 255, 0.1);\n    border-radius: 0;\n    pointer-events: none;\n}\n\n.poster-content {\n    background: rgba(255, 255, 255, 0.95) !important;\n    border-radius: 12px;\n    padding: 40px;\n    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.1);\n    backdrop-filter: blur(10px);\n    position: relative;\n    z-index: 1;\n    overflow: hidden;\n    word-wrap: break-word;\n    min-height: 400px;\n}\n\n.poster-content img {\n    max-width: 100%;\n    height: auto;\n    border-radius: var(--border-radius);\n    margin: 16px auto;\n    box-shadow: var(--shadow-md);\n    display: block;\n    object-fit: cover;\n}\n\n.poster-content h1 {\n    font-size: var(--dynamic-h1-size, 28px);\n    font-weight: 700;\n    color: var(--text-primary);\n    margin-bottom: 16px;\n    line-height: 1.3;\n}\n\n.poster-content h2 {\n    font-size: var(--dynamic-h2-size, 22px);\n    font-weight: 600;\n    color: var(--text-secondary);\n    margin: 24px 0 12px 0;\n    line-height: 1.4;\n}\n\n.poster-content h3 {\n    font-size: var(--dynamic-h3-size, 18px);\n    font-weight: 600;\n    color: var(--text-light);\n    margin: 20px 0 8px 0;\n}\n\n.poster-content p {\n    font-size: var(--dynamic-font-size, 16px);\n    color: var(--text-light);\n    margin-bottom: 16px;\n    line-height: 1.7;\n}\n\n.poster-content em {\n    font-style: italic;\n    color: var(--primary-color);\n}\n\n.poster-content strong {\n    font-weight: 700;\n    color: var(--text-primary);\n}\n\n.poster-content a {\n    color: var(--primary-color);\n    text-decoration: none;\n    border-bottom: 1px solid var(--primary-color);\n}\n\n.poster-content ul,\n.poster-content ol {\n    margin: 16px 0;\n    padding-left: 24px;\n}\n\n.poster-content li {\n    font-size: var(--dynamic-font-size, 16px);\n    color: var(--text-light);\n    margin-bottom: 8px;\n    line-height: 1.6;\n}\n\n.poster-content blockquote {\n    border-left: 4px solid var(--primary-color);\n    padding-left: 16px;\n    background: var(--background-gray);\n    padding-top: 12px;\n    padding-bottom: 12px;\n    margin: 16px 0;\n    color: var(--text-muted);\n    font-style: italic;\n    font-size: var(--dynamic-quote-size, 16px);\n}\n\n.poster-content blockquote p {\n    margin: 0;\n    line-height: inherit;\n}\n\n.poster-content code {\n    background: var(--background-gray);\n    padding: 2px 6px;\n    border-radius: 4px;\n    font-family: var(--font-mono);\n    font-size: var(--dynamic-code-size, 14px);\n    color: var(--primary-color);\n}\n\n.poster-content pre {\n    background: var(--text-primary);\n    color: #e2e8f0;\n    padding: 16px;\n    border-radius: var(--border-radius);\n    margin: 16px 0;\n    white-space: pre-wrap;\n    word-wrap: break-word;\n}\n\n.poster-content pre code {\n    background: transparent;\n    color: inherit;\n    padding: 0;\n}\n\n.poster-content table {\n    width: 100%;\n    border-collapse: collapse;\n    margin: 16px 0;\n    font-size: 14px;\n}\n\n.poster-content table th,\n.poster-content table td {\n    padding: 8px 12px;\n    border: 1px solid var(--border-color);\n    text-align: left;\n}\n\n.poster-content table th {\n    background: var(--background-light);\n    font-weight: 600;\n}\n";
+/**
+ * 生成自定义背景CSS
+ */
+export declare function generateCustomBackground(config: CustomBackground): string;
+/**
+ * 生成动态字体大小CSS变量
+ */
+export declare function generateFontSizeVars(baseFontSize: number): string;

package/dist/styles.js

@@ -0,0 +1,250 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FULL_STYLES = exports.BACKGROUND_PRESETS = exports.CSS_VARIABLES = void 0;
+exports.generateCustomBackground = generateCustomBackground;
+exports.generateFontSizeVars = generateFontSizeVars;
+/**
+ * CSS 变量定义
+ */
+exports.CSS_VARIABLES = `
+:root {
+    --primary-color: #6366f1;
+    --primary-hover: #4f46e5;
+    --secondary-color: #8b5cf6;
+    --text-primary: #1e293b;
+    --text-secondary: #334155;
+    --text-muted: #64748b;
+    --text-light: #475569;
+    --background-light: #f8fafc;
+    --background-gray: #f1f5f9;
+    --border-color: #e2e8f0;
+    --border-light: #cbd5e1;
+    --shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.1);
+    --shadow-md: 0 4px 12px rgba(0, 0, 0, 0.1);
+    --shadow-lg: 0 8px 32px rgba(0, 0, 0, 0.1);
+    --border-radius: 8px;
+    --border-radius-lg: 12px;
+    --font-mono: 'SF Mono', 'Monaco', 'Inconsolata', 'Roboto Mono', monospace;
+}
+`;
+/**
+ * 背景预设样式
+ */
+exports.BACKGROUND_PRESETS = {
+    purple: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
+    pink: 'linear-gradient(135deg, #f093fb 0%, #f5576c 100%)',
+    blue: 'linear-gradient(135deg, #4facfe 0%, #00f2fe 100%)',
+    green: 'linear-gradient(135deg, #43e97b 0%, #38f9d7 100%)',
+    sunset: 'linear-gradient(135deg, #fa709a 0%, #fee140 100%)',
+    pastel: 'linear-gradient(135deg, #a8edea 0%, #fed6e3 100%)',
+    peach: 'linear-gradient(135deg, #ffecd2 0%, #fcb69f 100%)',
+    rose: 'linear-gradient(135deg, #ff9a9e 0%, #fecfef 100%)',
+};
+/**
+ * 完整样式表
+ */
+exports.FULL_STYLES = `
+${exports.CSS_VARIABLES}
+
+* {
+    margin: 0;
+    padding: 0;
+    box-sizing: border-box;
+}
+
+body {
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+    background: var(--background-light);
+    color: var(--text-secondary);
+    line-height: 1.6;
+}
+
+.markdown-poster {
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    border-radius: 0;
+    padding: 40px;
+    margin: 20px;
+    box-shadow: 0 20px 40px rgba(0, 0, 0, 0.1);
+    width: 640px;
+    min-height: 600px;
+    position: relative;
+    overflow: hidden;
+    box-sizing: border-box;
+}
+
+.markdown-poster::before {
+    content: '';
+    position: absolute;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background: rgba(255, 255, 255, 0.1);
+    border-radius: 0;
+    pointer-events: none;
+}
+
+.poster-content {
+    background: rgba(255, 255, 255, 0.95) !important;
+    border-radius: 12px;
+    padding: 40px;
+    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.1);
+    backdrop-filter: blur(10px);
+    position: relative;
+    z-index: 1;
+    overflow: hidden;
+    word-wrap: break-word;
+    min-height: 400px;
+}
+
+.poster-content img {
+    max-width: 100%;
+    height: auto;
+    border-radius: var(--border-radius);
+    margin: 16px auto;
+    box-shadow: var(--shadow-md);
+    display: block;
+    object-fit: cover;
+}
+
+.poster-content h1 {
+    font-size: var(--dynamic-h1-size, 28px);
+    font-weight: 700;
+    color: var(--text-primary);
+    margin-bottom: 16px;
+    line-height: 1.3;
+}
+
+.poster-content h2 {
+    font-size: var(--dynamic-h2-size, 22px);
+    font-weight: 600;
+    color: var(--text-secondary);
+    margin: 24px 0 12px 0;
+    line-height: 1.4;
+}
+
+.poster-content h3 {
+    font-size: var(--dynamic-h3-size, 18px);
+    font-weight: 600;
+    color: var(--text-light);
+    margin: 20px 0 8px 0;
+}
+
+.poster-content p {
+    font-size: var(--dynamic-font-size, 16px);
+    color: var(--text-light);
+    margin-bottom: 16px;
+    line-height: 1.7;
+}
+
+.poster-content em {
+    font-style: italic;
+    color: var(--primary-color);
+}
+
+.poster-content strong {
+    font-weight: 700;
+    color: var(--text-primary);
+}
+
+.poster-content a {
+    color: var(--primary-color);
+    text-decoration: none;
+    border-bottom: 1px solid var(--primary-color);
+}
+
+.poster-content ul,
+.poster-content ol {
+    margin: 16px 0;
+    padding-left: 24px;
+}
+
+.poster-content li {
+    font-size: var(--dynamic-font-size, 16px);
+    color: var(--text-light);
+    margin-bottom: 8px;
+    line-height: 1.6;
+}
+
+.poster-content blockquote {
+    border-left: 4px solid var(--primary-color);
+    padding-left: 16px;
+    background: var(--background-gray);
+    padding-top: 12px;
+    padding-bottom: 12px;
+    margin: 16px 0;
+    color: var(--text-muted);
+    font-style: italic;
+    font-size: var(--dynamic-quote-size, 16px);
+}
+
+.poster-content blockquote p {
+    margin: 0;
+    line-height: inherit;
+}
+
+.poster-content code {
+    background: var(--background-gray);
+    padding: 2px 6px;
+    border-radius: 4px;
+    font-family: var(--font-mono);
+    font-size: var(--dynamic-code-size, 14px);
+    color: var(--primary-color);
+}
+
+.poster-content pre {
+    background: var(--text-primary);
+    color: #e2e8f0;
+    padding: 16px;
+    border-radius: var(--border-radius);
+    margin: 16px 0;
+    white-space: pre-wrap;
+    word-wrap: break-word;
+}
+
+.poster-content pre code {
+    background: transparent;
+    color: inherit;
+    padding: 0;
+}
+
+.poster-content table {
+    width: 100%;
+    border-collapse: collapse;
+    margin: 16px 0;
+    font-size: 14px;
+}
+
+.poster-content table th,
+.poster-content table td {
+    padding: 8px 12px;
+    border: 1px solid var(--border-color);
+    text-align: left;
+}
+
+.poster-content table th {
+    background: var(--background-light);
+    font-weight: 600;
+}
+`;
+/**
+ * 生成自定义背景CSS
+ */
+function generateCustomBackground(config) {
+    return `linear-gradient(${config.direction}, ${config.colorStart} 0%, ${config.colorEnd} 100%)`;
+}
+/**
+ * 生成动态字体大小CSS变量
+ */
+function generateFontSizeVars(baseFontSize) {
+    return `
+    --dynamic-font-size: ${baseFontSize}px;
+    --dynamic-h1-size: ${Math.round(baseFontSize * 1.75)}px;
+    --dynamic-h2-size: ${Math.round(baseFontSize * 1.375)}px;
+    --dynamic-h3-size: ${Math.round(baseFontSize * 1.125)}px;
+    --dynamic-h4-size: ${Math.round(baseFontSize * 1.05)}px;
+    --dynamic-h5-h6-size: ${Math.round(baseFontSize * 0.95)}px;
+    --dynamic-code-size: ${Math.round(baseFontSize * 0.875)}px;
+    --dynamic-quote-size: ${Math.round(baseFontSize * 0.95)}px;
+  `;
+}

package/dist/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 导出模式枚举
+ */
+export declare enum ExportMode {
+    /** 自由模式,根据内容自适应高度 */
+    FREE = "free",
+    /** 小红书模式,固定 3:4 比例 */
+    XHS = "xhs",
+    /** 朋友圈模式,固定 1290:2796 比例 */
+    PYQ = "pyq"
+}
+/**
+ * 背景渐变预设
+ */
+export type BackgroundPreset = 'purple' | 'pink' | 'blue' | 'green' | 'sunset' | 'pastel' | 'peach' | 'rose';
+/**
+ * 渐变方向
+ */
+export type GradientDirection = '0deg' | '45deg' | '90deg' | '135deg' | '180deg' | '270deg';
+/**
+ * 自定义背景配置
+ */
+export interface CustomBackground {
+    colorStart: string;
+    colorEnd: string;
+    direction: GradientDirection;
+}
+/**
+ * 扩展功能配置
+ */
+export interface ExtensionOptions {
+    /**
+     * 是否启用数学公式支持 (KaTeX)
+     * @default true
+     */
+    enableMath?: boolean;
+    /**
+     * 是否启用图表支持 (Mermaid)
+     * @default true
+     */
+    enableDiagram?: boolean;
+    /**
+     * 是否启用卡片语法
+     * @default true
+     */
+    enableCard?: boolean;
+}
+/**
+ * 转换配置选项
+ */
+export interface Md2ImageOptions {
+    /**
+     * 导出模式
+     * @default ExportMode.XHS
+     */
+    mode?: ExportMode | 'free' | 'xhs' | 'pyq';
+    /**
+     * 整体宽度(像素)
+     * @default 640
+     */
+    width?: number;
+    /**
+     * 内边距(像素)
+     * @default 40
+     */
+    padding?: number;
+    /**
+     * 基础字体大小(像素)
+     * @default 18
+     */
+    fontSize?: number;
+    /**
+     * 背景预设
+     */
+    backgroundPreset?: BackgroundPreset;
+    /**
+     * 自定义背景
+     */
+    customBackground?: CustomBackground;
+    /**
+     * 导出缩放倍数,影响输出图片清晰度
+     * @default 2
+     */
+    scale?: number;
+    /**
+     * 输出文件路径
+     */
+    outputPath?: string;
+    /**
+     * 扩展功能配置
+     */
+    extensions?: ExtensionOptions;
+}
+/**
+ * 转换结果
+ */
+export interface ConvertResult {
+    /**
+     * 生成的图片路径
+     */
+    imagePath: string;
+    /**
+     * 图片宽度
+     */
+    width: number;
+    /**
+     * 图片高度
+     */
+    height: number;
+}

package/dist/types.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExportMode = void 0;
+/**
+ * 导出模式枚举
+ */
+var ExportMode;
+(function (ExportMode) {
+    /** 自由模式,根据内容自适应高度 */
+    ExportMode["FREE"] = "free";
+    /** 小红书模式,固定 3:4 比例 */
+    ExportMode["XHS"] = "xhs";
+    /** 朋友圈模式,固定 1290:2796 比例 */
+    ExportMode["PYQ"] = "pyq";
+})(ExportMode || (exports.ExportMode = ExportMode = {}));

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "md2xhs",
+  "version": "1.0.0",
+  "description": "将 Markdown 转换为适合小红书发布的精美图片 - Convert Markdown to beautiful images for Xiaohongshu",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && npm run copy-assets",
+    "copy-assets": "mkdir -p dist/assets && cp -r src/assets/* dist/assets/",
+    "prepublishOnly": "npm run build",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "markdown",
+    "markdown-to-image",
+    "image",
+    "xiaohongshu",
+    "social-media",
+    "converter",
+    "export",
+    "markdown-converter",
+    "image-generator",
+    "katex",
+    "mermaid",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/md2xhs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yourusername/md2xhs/issues"
+  },
+  "homepage": "https://github.com/yourusername/md2xhs#readme",
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "marked": "^11.0.0",
+    "puppeteer": "^24.15.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3"
+  }
+}