markdown-paper 3.1.1 → 3.2.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [3.2.0](https://github.com/LeafYeeXYZ/MarkdownPaper/compare/v3.1.1...v3.2.0) (2026-03-19)
+
+
+### Features
+
+* 支持自动使用系统安装的Chrome ([128528b](https://github.com/LeafYeeXYZ/MarkdownPaper/commit/128528ba10b64246b96b03e64ec688f8c0f83321))
+
 ## [3.1.1](https://github.com/LeafYeeXYZ/MarkdownPaper/compare/v3.1.0...v3.1.1) (2025-06-12)
 
 

package/README.md

@@ -74,7 +74,13 @@ bun add -g markdown-paper
 
 > 如果您安装过旧版本的 `MarkdownPaper` (小于 `2.0.0`), 请先卸载旧版本再安装新版本
 
-## 4 生成论文
+## 4 安装 `Chrome` 浏览器
+
+`MarkdownPaper` 使用 `Puppeteer` 库将 `Markdown` 转换为 `PDF` 文件, 需要依赖 `Chrome` 浏览器; 请确保您的系统中安装了 `Chrome` 浏览器, 如果没有安装, 请前往 [Google Chrome 官网](https://www.google.com/chrome/) 下载并安装
+
+`MarkdownPaper` 默认会读取 `C:\Program Files\Google\Chrome\Application\chrome.exe` (Windows) 或 `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome` (macOS) 路径下的 `Chrome` 浏览器, 如果您的 `Chrome` 浏览器安装在其他路径, 请在生成论文时使用 `--browser <path>` 选项指定浏览器路径
+
+## 5 生成论文
 
 运行 `mdp` 命令以使用 `MarkdownPaper` 命令行工具从 `Markdown` 文件生成论文
 
@@ -91,6 +97,8 @@ mdp themes
 mdp example.md # 可以省略 .md 后缀
 ```
 
+> 注: 如果自带模板无法满足您的需求, 您也可以在 `Markdown` 文件中直接书写 `<style></style>` 等 HTML 标签来实现自定义样式, 但请注意这可能会影响到论文的格式和样式
+
 # 模板说明
 
 `/lib/types.ts` 中的 `MarkdownnPaperTheme` 类型定义了论文模板; 模板制作完成后, 在 `/lib/types.ts` 中导入并添加即可使用

package/bin/mdp.ts

@@ -8,6 +8,15 @@ import { version } from '../package.json'
 
 const program = new Command()
 const cwd = process.cwd()
+let browser = '/usr/bin/google-chrome'
+switch (process.platform) {
+	case 'win32':
+		browser = 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
+		break
+	case 'darwin':
+		browser = '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome'
+		break
+}
 
 program
 	.name('mdp')
@@ -20,6 +29,7 @@ program
 	.option('--docx --output-docx', '输出DOCX文件', false)
 	.option('--hide-footer', '隐藏页脚页码', false)
 	.option('--punctuation <zh/en/origin>', '标点符号格式', 'zh')
+	.option('--browser <path>', 'Puppeteer浏览器路径 (默认为系统安装的Chrome)', browser)
 	.command('themes', '显示所有可用的论文模板')
 	.action((markdown, options) => {
 		console.log('开始生成')

package/lib/main.ts

@@ -6,7 +6,7 @@ import { asBlob } from 'html-docx-js-typescript'
 import katexCss from 'katex/dist/katex.css' with { type: 'text' }
 import { marked } from 'marked'
 import markedKatex from 'marked-katex-extension'
-import puppeteer from 'puppeteer'
+import puppeteer from 'puppeteer-core'
 import { type MarkdownPaperOptions, themes } from './types'
 
 /**
@@ -43,7 +43,9 @@ export async function render(options: MarkdownPaperOptions): Promise<void> {
 			return match
 		}
 	})
-	const browser = await puppeteer.launch()
+	const browser = await puppeteer.launch({
+		executablePath: options.browser,
+	})
 	const page = await browser.newPage()
 	await page.setContent(html)
 	await page.evaluate(theme.script)

package/lib/types.ts

@@ -1,4 +1,4 @@
-import type { PDFOptions } from 'puppeteer'
+import type { PDFOptions } from 'puppeteer-core'
 import { z } from 'zod'
 import { themeAPS } from './themes/aps'
 
@@ -28,6 +28,7 @@ export const cliOptions = z.object({
 	outputDocx: z.boolean(),
 	hideFooter: z.boolean(),
 	punctuation: z.enum(['zh', 'en', 'origin']),
+	browser: z.string(),
 })
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "markdown-paper",
-	"version": "3.1.1",
+	"version": "3.2.0",
 	"author": {
 		"name": "LeafYeeXYZ",
 		"email": "xiaoyezi@leafyee.xyz"
@@ -10,7 +10,7 @@
 		"html-docx-js-typescript": "^0.1.5",
 		"marked": "^12.0.2",
 		"marked-katex-extension": "^5.1.4",
-		"puppeteer": "^22.15.0",
+		"puppeteer-core": "^24.39.1",
 		"zod": "^3.25.56"
 	},
 	"peerDependencies": {