以心理学报等学术论文的格式从 Markdown 生成 PDF / HTML / DOCX 文件

使用方法

1 用 Markdown 撰写论文

# 中文标题

#author# 作者信息
#school# 单位信息
#abstract# 摘要内容
#keywords# 关键词内容

## 1 一级标题

### 1.1 二级标题

#### 1.1.1 三级标题

正文

#### 1.1.2 数学公式

段内数学公式: $c = \pm\sqrt{a^2 + b^2}$

单独数学公式:

$$
c = \pm\sqrt{a^2 + b^2}
$$

#### 1.1.3 图片

![](图片路径)

> 图片标题

#### 1.1.4 表格

> 表格标题

| 表头1 | 表头2 |
| :---: | :---: |
| 内容1 | 内容2 |

##### 参考文献

- 文献1
- 文献2
- 文献3

---

(上面的是分页符)

##### 附录

数学公式语法详见 https://katex.org 和这篇中文文章

2 安装 Node.js

MarkdownPaper 基于 Node.js (v23+) 原生 TypeScript 支持运行；请在官网 nodejs.org 下载并安装 Node.js 的最新稳定版本

3 安装 MarkdownPaper

npm install -g markdown-paper

4 安装 Chrome 浏览器

MarkdownPaper 使用 Puppeteer 将 Markdown 转换为 PDF 文件, 需要依赖 Chrome 浏览器; 请确保您的系统中安装了 Chrome 浏览器, 如果没有安装, 请前往 Google 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 文件生成论文

如果您不熟悉命令行工具, 可以尝试我的另一个项目 EasyPaper, 它实现了大部分 MarkdownPaper 的功能并提供了图形界面

# 查看帮助信息
mdp --help
# 查看版本信息
mdp --version
# 查看可用的论文模板
mdp themes
# 从当前工作目录下的 example.md 文件生成 PDF 文件
mdp example.md # 可以省略 .md 后缀

注: 如果自带模板无法满足您的需求, 您也可以在 Markdown 文件中直接书写 <style></style> 等 HTML 标签来实现自定义样式, 但请注意这可能会影响到论文的格式和样式

模板说明

/lib/types.ts 中的 MarkdownnPaperTheme 类型定义了论文模板; 模板制作完成后, 在 /lib/types.ts 中导入并添加即可使用