Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/leafyeexyz/easypaper

初学者撰写学术论文的最简单方式, 支持 Windows + MacOS
https://github.com/leafyeexyz/easypaper

academic academy ant-design antd article beijing-normal-university bnu electron electron-vite markdown paper psychology react tailwind tailwindcss typescript

Last synced: about 21 hours ago
JSON representation

初学者撰写学术论文的最简单方式, 支持 Windows + MacOS

Awesome Lists containing this project

README 

        
# EasyPaper



**初学者撰写学术论文的最简单方式**



![](./readme/0.png)



## 前言



本软件旨在解决大学新生最头疼的问题之一: 调整论文格式, 帮助初学者更多地把精力放在写作本身上. 它基于十分简单的 Markdown 语法 (哪怕你没听过, 参考下面的示例也能马上上手), 通过图形界面实时预览, 并一键导出指定格式的学术论文



相比于 LaTeX, 本软件更加简单易用, 省去了复杂的配置和学习成本, 但仍然能够满足大部分学术论文的排版需求; 相比于 Word, 本软件完全接管了格式调整的工作, 你只需选择指定的论文模板 (目前仅支持心理学报格式), 专心写作即可



如果你有一定的计算机基础, 也推荐您使用命令行程序 [MarkdownPaper](https://github.com/LeafYeeXYZ/MarkdownPaper), 它的处理逻辑与本软件基本一致, 但更加灵活和强大 (如支持导出 DOCX 文件), 您还可以使用任何您喜欢的编辑器撰写学术论文



## 使用方法



### 1 下载安装



![](./readme/1.png)



![](./readme/2.png)



> 由于作者没钱开通 `Apple Developer` 账号, 所以 `MacOS` 下可能提示软件已损坏, 请参见[这篇文章](https://www.mac2m.com/article/450/)修复; 如果您熟悉 `Node.js`, 也可自行编译, 参见文末



### 2 新建文档



![](./readme/3.png)



![](./readme/4.png)



### 3 写论文



书写格式如下:



```markdown

# 这是你论文的标题



#author# 小叶子



#school# (北京师范大学心理学部, 北京 100875)



#abstract# 摘要内容摘要内容摘要内容摘要内容摘要内容摘要内容摘要内容摘要内容摘要内容摘要内容摘要内容摘要内容



#keywords# 关键词1, 关键词2, 关键词3



## 1 一级标题



### 1.1 二级标题



#### 1.1.1 三级标题



#### 1.1.2 正文写法



正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文正文



每个自然段之间必须有一个空行



#### 1.1.3 数学公式写法



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



这是单独数学公式的写法:



$$

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

$$



#### 1.1.4 表格写法



表格会自动根据内容调整宽度, 但是内容过长时会自动换行



> 表 1 - 这是表格的标题



| 表头1 | 表头2 |

| :---: | :---: |

| 内容1 | 内容2 |



注意, 不同论文对表格和图片标题在上方或下方有不同的要求, 请根据具体要求调整



#### 1.1.5 图片写法



将图片放在和 `.md` 同一个文件夹下, 然后使用 ![](图片文件名) 插入图片, 例如:



![](123.jpg)



> 图 1 - 这是图片的标题



## 2 一级标题



### 2.1 二级标题



#### 2.1.1 三级标题



...



##### 参考文献



- 文献1

- 文献2

- 文献3



##### 附录



附录可以放图片、表格等等等等

```



> 数学公式语法详见 [https://katex.org](https://katex.org) 和[这篇中文文章](https://kissingfire123.github.io/2022/02/18_数学公式katex常用语法总结)



### 4 导出论文



![](./readme/5.png)



## 未来展望



本软件的技术栈为 `Electron(Electron Vite)` + `React` + `TailwindCSS` + `Ant Design`; 如果您想**参与开发新论文模板**, 请在 `/lib/themes.ts` 中定义并导出类型为 `MarkdownPaperTheme` 的对象, 并在 `/lib/utils.ts` 导入并将其添加到 `THEMES` 数组中



- [ ] 支持更多的论文格式

- [ ] 文章进度跟随 (Markdown编辑器和HTML预览器匹配)

- [x] 支持插入 LaTeX 公式

- [ ] 独立的参考文献管理

- [ ] AI 文章润色和参考文献查询 (基于本地 ollama)

- [ ] 给软件弄一个漂亮的图标



## 开发说明



在开始前, 请自行安装 `Node.js`, 推荐安装 [`Bun`](https://bun.sh) 作为包管理工具



```bash

# 1 克隆项目

git clone https://github.com/LeafYeeXYZ/EasyPaper.git



# 2 进入项目目录

cd ./EasyPaper



# 3 安装依赖

bun install # 或 npm install



# 4 开发和构建



# 4.1 开发

bun dev # 或 npm run dev



# 4.2 构建 Windows 和 macOS 应用

bun build:both # 或 npm run build:both

```



#### 项目结构



- `lib`: 存放论文模板(主题)相关内容, 被 `main`、`preload`、`renderer` 共用 (注意兼容性)

- `src/main`: 主进程

- `src/preload`: 预加载脚本

- `src/renderer`: 渲染进程

- `readme`: 存放 `README.md` 中的图片

- `resources`: 存放软件图标