# 我们的理念

一个产品的价值，永远应该建立在「如何帮助使用它的人实现价值」之上。

木及简历想解决的不是“再做一个简历编辑器”这么简单的问题，而是希望让每个认真准备求职的人，把更多注意力放回到自己的经历、能力、思考和表达本身。

在传统的简历制作过程中，很多时间被消耗在字体、间距、对齐、页边距、导出格式和模板调整上。对于大多数求职者来说，这些并不是最重要的事情。真正重要的是：你做过什么、解决过什么问题、产生过什么结果，以及你如何把这些内容清楚地讲出来。

木及简历希望做的是，把排版和工具层面的复杂度尽可能收起来，让你专注于内容。

## 为什么选择 Markdown

Markdown 是一种轻量级标记语言，它足够简单，也足够稳定。相比传统富文本编辑器，Markdown 更接近“写作”本身：

- 你可以用标题组织信息层级；
- 你可以用列表梳理项目经历；
- 你可以用加粗突出结果和关键词；
- 你可以用链接补充博客、作品集和 GitHub；
- 你可以用少量扩展语法完成左右结构和更复杂的简历排版。

这也是木及简历选择 Markdown 的核心原因：它不应该要求你成为设计师，也不应该让你花大量时间和版式较劲。

你只需要把内容写清楚，剩下的交给模板和主题系统。

## 我们希望减少什么

我们不希望在简历制作过程中，你被复杂的交互所干扰，或者为设计本身焦虑。

我们希望减少这些成本：

1. **减少排版成本**：不用反复拖拽文本框，不用手动对齐每一段内容。
2. **减少迁移成本**：Markdown 文本天然轻量，便于保存、复制、版本管理和二次编辑。
3. **减少试错成本**：通过模板、主题和预览，让你快速看到最终效果。
4. **减少导出成本**：尽可能稳定地生成适合投递的 PDF 简历。

工具应该服务于表达，而不是反过来占据表达本身。

## 我们更关注什么

木及简历更关注简历内容的质量，以及求职者是否能高效完成一次完整表达。

一份好的简历，不只是“好看”，还应该做到：

- 信息层级清晰，HR 能快速扫到重点；
- 经历描述具体，有背景、动作和结果；
- 项目经验突出个人贡献，而不是堆砌技术名词；
- 技能描述真实可信，能和经历相互印证；
- 版式稳定，不因为设备、软件或导出方式发生明显错乱。

因此，木及简历会持续在模板、编辑体验、导出稳定性、内容辅助和插件能力上迭代。

## 关于开源与共建

木及简历基础版开源于 [GitHub](https://github.com/)，上线至今已经帮助用户导出大量简历。它仍然不是一个完美成熟的产品，但它一直在根据真实用户的反馈持续成长。

维护一个长期可用的工具并不容易。很多改进并不显眼，例如兼容不同浏览器、处理 PDF 导出细节、优化模板样式、修复边界问题、补充帮助文档、改进移动端体验等。

这些工作可能不够“酷”，但它们决定了一个工具是否真的可靠。

也正因为有用户持续使用、反馈、建议和支持，木及简历才有继续往前走的动力。

## 我们相信

我们相信，简历工具不应该制造更多焦虑。

我们相信，好的工具应该让人更接近目标，而不是更沉迷工具本身。

我们相信，每个人都值得拥有一份清晰、专业、稳定、能认真表达自己的简历。

木及简历会继续围绕这个方向迭代：

- 让 Markdown 写简历更简单；
- 让模板更专业、更适合真实求职场景；
- 让导出更稳定；
- 让帮助文档更完整；
- 让用户能更专注地完成自己的内容。

感谢每一个参与共建、提出建议、反馈问题、持续使用木及简历的你。

愿你写出满意的简历，也走好职场的每一步。


我们的理念

关于木及简历

# 🧑‍🌾 如何插入证件照？

在木及简历中插入证件照有两种常用方式。推荐优先使用证件照插件，操作更直观，也方便后续调整位置和大小。

## 方法一：证件照插件（推荐）

在插件列表里找到「证件照插件」，即可上传证件照。

上传照片后，图片就可以任意拖拽位置和改变大小 👇

## 方法二：拖拽照片进入编辑器

拖拽照片直接进入编辑区某一位置，图片就会被插入到那个指定位置。

这种方式适合你已经准备好图片，并且希望快速放到简历某个区域的场景。

## 方法三：使用 img 标签

如果你已经有图片链接，也可以直接在 Markdown 中插入一段 HTML：

```html
<img src="https://s3.mdedit.online/muji/muji-zhengjian.jpg" style="width:90px;position:absolute;top:40px;right:50px;">
```

其中：

- `src` 是图片地址；
- `width` 控制图片宽度；
- `top` 和 `right` 控制图片位置。

如果你不熟悉 HTML 或 CSS，建议优先使用「证件照插件」。

## 常见问题

### 上传后还能调整吗？

可以。点击图片后，可以拖拽图片改变位置，也可以拖动控制点改变大小。

### 图片应该用什么比例？

常规证件照比例即可。建议使用清晰、正面、背景干净的照片，避免过度裁剪或压缩。

### 没有图片链接怎么办？

可以先使用图床上传图片，再复制图片 URL。也可以直接使用插件上传，省去手动处理链接的步骤。


如何插入证件照？

# 🙌 如何实现左右、左中右布局？

在简历中，经常会遇到需要左右排版的内容，例如「学校 / 时间」「公司 / 岗位 / 时间」「项目名称 / 项目链接」等。

木及简历提供了两种方式来实现左右或左中右布局。推荐优先使用 table 表格，操作更直观，也更适合大多数简历场景。

## 方法一：table 表格（推荐🌸）

新起一行，鼠标停留到空行的前面，会出来一个列表，选择 table 表格的图标插入表格。

插入表格后，默认是两列。如果需要左中右结构，可以再添加一列。

每列都可以调整文字的居左、居中、居右对齐。常见用法是：左边放名称，中间放补充信息，右边放时间或地点。

三列表格的效果如下：👇

```text
| 学校 / 公司 | 专业 / 岗位 | 时间 |
| --- | --- | --- |
| 北京邮电大学 | 计算机科学与技术 | 2018.09 - 2022.06 |
| 木及科技 | 前端开发工程师 | 2022.07 - 至今 |
```

在简历里你可以这样使用：

```text
| 木及科技 | 前端开发工程师 | 2022.07 - 至今 |
| --- | --- | --- |
| 负责在线简历编辑器、模板广场和导出链路优化 | React / Next.js | 北京 |
```

## 方法二：left、right 实现左右布局

同样新起一行，鼠标悬浮在空行前面，可以快速添加左右布局。加好后效果如下边右图所示：👇

如果你习惯直接写 Markdown，也可以使用木及简历扩展语法：

```text
::: left
这里写左侧内容
:::

::: right
这里写右侧内容
:::
```

例如：

```text
::: left
### 木及科技 - 前端开发工程师
负责在线简历编辑器、模板广场、导出 PDF 等核心功能。
:::

::: right
2022.07 - 至今
北京
:::
```

## 方法三：left、center、right 实现三列布局

如果你需要左中右三列，可以增加 center 区块：

```text
::: left
左侧内容
:::

::: center
中间内容
:::

::: right
右侧内容
:::
```

这种方式适合更自由的排版，例如左侧写项目名称，中间写技术栈，右侧写时间。

## 使用建议

- 普通经历条目：优先使用 table 表格。
- 需要复杂排版：可以使用 left / center / right 扩展语法。
- 不要为了排版牺牲可读性，简历最重要的是让关键信息清晰呈现。
- 如果只是「左边标题，右边时间」，两列表格通常已经够用。


如何实现左右、左中右布局？

编辑器相关

# 木及简历入门教程

## 1.标题层级该怎么写？

木及简历可以写出很多漂亮的主题简历，但是同时我们也 Markdown 扩展了一些额外的解析规则，因此也会对写法有一定的规范。

建议在写简历过程中，使用**一级标题**来写在开头，常用来描述整体的主旨与标题，常用的就是，求职者的姓名 + 求职岗位的模式

例如: 

\# 秋风 - 前端工程师

这样不仅能能让面试官一眼就看到你这份简历的用途，因为在实际过程中，有很多同学没有很好地注明投递的方向，很容易造成投递方向错误。

在写内容过程中，建议使用**二级标题**来写。

例如: 

\## 教育背景 

\## 工作经验

\## 项目经验

\## 基础技能

![1615716349000](https://s3.mdedit.online/blog/1615716349000.jpg)



## 2.如何写左右结构？
由于在 Markdown 中直接写左右结构比较困难，因此我们扩展了 Markdown 的基础语法。这个抒写语法，对于 Markdown 重度使用者也不是什么高级的语法， VuePress、React官网等各大社区网站中都有用到。

示例:

![WechatIMG30782](https://s3.mdedit.online/blog/WechatIMG30782.png)


## 3.换主题颜色？

在部分模板中，你可以通过更换自己所喜欢的主题色。

点击预览的右上方按钮，可以进行更换主题色景。

![1615716042526](https://s3.mdedit.online/blog/1615716042526.jpg)

注意，只有标记可换色的模板才可以进行更换主题色。

![1615716378016](https://s3.mdedit.online/blog/1615716378016.jpg)


## 4.遇到生成失败问题

建议重新点击导出 pdf，如果遇到 5 次以上可不使用，建议咨询客服。

## 5.客服咨询

你在使用中有任何问题，可以添加技术客服微信（qiufengblue）进行咨询，技术客服会拉你进入讨论群，讨论群中包含且不限于，本项目的未来发展、问题解答以及功能更新。



木及简历入门教程

# Markdown 简历书写教程

`Markdown` 是一种轻量级标记语言，它允许我们使用很简单的格式来编写文档。

这里是一篇结合「木及简历」的 Markdown 书写教程，力求从 **实用的角度** 出发来介绍常用的规则。

因此并不会介绍 **全部** 的 Markdown 语法，学习更多可以移步 👉 [Markdown 教程](https://www.runoob.com/markdown/md-tutorial.html)

## 1. 使用 # 号标记标题

我们使用 # 号开头可表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。

```text
# 一级标题
## 二级标题
### 三级标题
```

1. 在写简历时，建议使用 **一级标题** 来写姓名和求职岗位，以突出最有用的信息，如：**# 秋风 - 前端开发工程师**

2. 建议使用 **二级标题** 来写模块标题，例如`教育经历`、`工作经验`、`项目经验`、`技能特长`、`自我评价`等，如： **## 教育经历**

3. 建议使用 **三级标题** 来书写每个模块下的分块标题，例如`学校名称`、`公司名称`、`项目名称`等，如： **### 北京邮电大学 - 计算机科学及技术 (2018.09 - 2022.06)**

## 2. 支持左右（左中右）结构 🎉

**方法①：**

由于 Markdown 中直接写左右结构比较困难，而在简历的书写场景避免不了有「**使用左右结构来展现**」的需求，因此我们扩展了 Markdown 的基础语法。

使用一对`:::`包裹住你的左右块，并写上`left` `right`标志。如果需要中间一列，加上中间的 center 即可，不需要则只写 left 和 right 即可。示例如下：

```text
::: left
🎉 这里书写你的左侧 Markdown 内容
:::

::: center
🎉 这里书写你的中间 Markdown 内容
:::

::: right
🎉 这里书写你的右侧 Markdown 内容
:::
```

**方法②（推荐）：**

同样支持使用表格 **table** 来书写 **左右（两列）** 或 **左中右（三列）** 结构，如下图所示在编辑器中插入表格填写内容即可：

![表格左右结构示例](https://cdn2.flowus.cn/oss/0abcc538-22d0-4d3a-8df6-b568739ec4af/image.png?time=1782128700&token=c0773df83fadc6de792afde32e872e66ba59c63408348c932182893f944b23c9&role=free&rate=512)

![表格三列结构示例](https://cdn2.flowus.cn/oss/579c87e4-f5ee-4b43-b27f-c08bac5a607c/image.png?time=1782128700&token=b5de6daa5ca1de0fc121ee72b3f6348c56d4eda40dceb8ab0a9e85a379fd3bfa&role=free&rate=512)

## 3. 多种文字样式

用一对`*`号包裹住文字，使其变为斜体，如：`*斜体*` 👉 *斜体*

用一对`**`号包裹住文字，使其变为粗体来「加重」某些关键词，如：`**粗体**` 👉 **粗体**

用一对反引号包裹着文字，使其变为标签样式，如：`标签` 👉 `标签`

## 4. 使用数字和减号实现列表

对于有序列表，我们可以用数字并加上 `.` 号来表示，如：

```text
1. 第一项
2. 第二项
3. 第三项
```

对于无序列表，我们可以用减号 `-` 来表示，如：

```text
- 第一项
- 第二项
- 第三项
```

还可以把它们组合使用，如：

```text
1. 第一项
    - 第一项嵌套元素
    - 第一项嵌套元素
2. 第二项
    - 第二项嵌套元素
    - 第二项嵌套元素

- 前端架构组
    - 前端错误监控系统
```

## 5. 插入链接

插入链接的方法如下：

```text
[链接名称](链接地址)

或者

<链接地址>
```

一般我们在简历上会放上个人主页、博客和 GitHub 链接等，可以让 HR、面试官直达。如：

```text
[我的博客：https://qiufeng.blue](https://qiufeng.blue)
[我的博客](https://qiufeng.blue)

或者

我的博客：<https://qiufeng.blue>
```

## 6. 支持语义化图标 ✨

我们提供了一个图标列表，大概有几百个小图标。

![语义化图标列表](https://cdn2.flowus.cn/oss/b1db9f59-4d1c-4ed2-8774-45df360211cc/image-20210904170243267.png?time=1782128700&token=3c3a4a93f17504d68209ac506ed54d4f6f7273a322fcad163a4ccc35b1a7a8e5&role=free&rate=512)

示例使用效果如下：

![语义化图标效果](https://cdn2.flowus.cn/oss/d930eee3-4120-491d-a81b-86a9f772d007/image-20210904170429420.png?time=1782128700&token=775e2e5601178baf0b6b81f7bc722563e247ca38fd0e7b0c1476ee00fcd45fa0&role=free&rate=512)

## More 💡

以上是简单介绍了一下 Markdown 的一些写法。

由于我们是基于 Markdown 来构建简历，很多自主权其实把握在自己手里。

所以还有更多写法和展示待你发挥想象力，去探索、去发掘。

例如「把 GitHub Profile 加入你的简历」、「把图标 icon 置于各级标题前」等诸多好玩的用法。

如果你对以上有更好的建议或疑惑的问题，欢迎来与我们进行交流 👏。


木及简历帮助中心

简单介绍 (,,・∀・)ﾉﾞ

帮助主题

新人引导

常见问题

教程相关

可以从这里继续

相关资源

帮助

联系我们

友情链接