LapisCV VSCode 简历模板指南:用 Markdown 在 VSCode 中快速制作专业简历

原创2026-10-14 13:05:48420 阅读
文章标签:开发工具

LapisCV VSCode 简历模板指南:用 Markdown 在 VSCode 中快速制作专业简历

本篇技术指南以 LapisCV 仓库中的 VSCode 英文简历模板(templates/vscode/template-en.md)为核心,讲解如何借助该模板在 VSCode 中通过纯 Markdown 撰写、预览并导出 PDF 简历,涵盖模板语法结构、图标与头像配置、分页页码、页边距以及基于 CSS 变量的自定义样式方案。读完本文,你将能直接上手使用 LapisCV 模板,并结合仓库源码实现简历排版与样式的精细调优。

LapisCV 是一款基于 Markdown 的简历方案,支持在 VSCode / Typora / Obsidian 三个平台使用,其风格简洁正式,适用于大部分求职场景。与另行编写 HTML/CSS 简历不同,LapisCV 将简历的“内容结构”与“视觉样式”彻底分离:内容全部以 Markdown 编写(对应模板文件),样式统一由 CSS 变量驱动(对应 styles 目录),因此同一份内容可以在不同编辑器中呈现一致的效果。

一、模板结构速览:一份简历由哪些部分组成

打开 templates/vscode/template-en.md,可以看到一份完整的英文示例简历(示例人物为 “The Octocat”),其结构共分六个部分:

  1. 姓名标题区(H1):简历最顶部的 # The Octocat 标题;
  2. 联系信息栏(blockquote):通过引用块排版电话号码、邮箱、个人链接;
  3. 头像(HTML <img>):右上角圆形头像;
  4. 教育经历(Education);
  5. 工作经历(Work Experience);
  6. 项目经历(Projects);
  7. 专业技能(Skills)。

模板的核心套路是:用 Markdown 标题组织章节,用引用块承载个人信息栏,用 <div alt="entry-title"> 结构承载“机构名 + 时间”的双栏条目,用无序列表承载经历要点。其中带 alt 属性的 HTML 标签(如 <div alt="entry-title">、<span alt="icon">)会被样式表识别并应用对应的排版规则,这正是模板能在多个平台保持排版一致的关键。

在开始编辑前,可以先对照 README.md 中的预览样张(LapisCV 主题效果)了解最终呈现效果。对于有中英文双简历需求的开发者,仓库还提供了中文版模板 templates/vscode/template-cn.md 以及 Typora、Obsidian 平台对应的模板,结构完全一致,可随时切换使用。

二、VSCode 环境准备:三步让模板跑起来

1. 获取文件并打开

下载 LapisCV Release 并解压后,在 VSCode 中直接打开解压目录即可。仓库目录中的 templates/vscode/template-en.md 是模板源文件,Release 包中会包含编辑所需的全部样式资源。如果想从源码构建 Release 产物,可参考 Makefile 中的 make vscode 目标——它会把 templates/vscode/ 下的模板与 styles/classic/vscode.css(或 styles/serif/vscode.css)、styles/main.css、fonts/ 组装到 build/vscode 目录,形成开箱即用的文件夹。

2. 安装 Markdown PDF 插件

LapisCV 在 VSCode 下的 PDF 导出依赖社区插件 Markdown PDF(作者 yzane)。安装后在 VSCode 右上角点击预览图标即可实时查看渲染效果;右键 Markdown 文档选择 “Markdown PDF - Export (pdf)” 即可导出 PDF。

注意:其他 VSCode 插件可能影响样式,若预览效果与预期不一致,请检查是否有插件干扰了 Markdown 渲染。

3. 预览与导出

打开模板文件后,点击编辑器右上角的预览图标可实时查看效果。模板中所有内容修改(如替换标题、增删条目、更换头像)都会在预览窗中即时刷新,无需重新加载样式。

三、逐段解析模板语法与排版逻辑

3.1 标题与联系信息栏

模板的标题区代码如下:

# The Octocat

> <span alt="icon">&#xe60f;</span> `(123)456-7890`&emsp;&emsp; <span alt="icon">&#xe7ca;</span> `octocat@github.com`&emsp;&emsp; <span alt="icon">&#xe600;</span> [octocat](https://github.com/octocat)
  • # 标题最终渲染为简历大标题。在 styles/main.css 中,h1 被设置为 font-family: var(--title-font)、text-align: center,默认字号由 --h1-size 控制。
  • 引用块(>)被样式表专门处理为“居中信息栏”:blockquote 的 line-height: 1.6、font-size: var(--blockquote-size),且 h1, blockquote p 均居中。联系信息中的 &emsp;&emsp;(全角空格)用于在电话、邮箱、链接之间制造横向间隔。
  • 电话与邮箱用反引号包成行内代码,链接用 Markdown 链接语法。在样式中,a 元素使用 --link-font(JetBrainsMono 等宽字体),行内 code 使用 --code-font,整体呈现出“信息栏即代码”的专业感。

3.2 头像配置

模板中的头像通过一行 HTML 图片插入:

<img alt="avatar" src="https://avatars.githubusercontent.com/u/583231?v=4">
  • 编辑时只需替换 src 为你的头像图片路径或 URL;不需要头像时直接删除该行。
  • 在 styles/main.css 中,img[alt="avatar"] 被定义为:float: right(右浮动)、border-radius: 50%(圆形裁剪)、宽高均取 var(--avatar-width)、并带 2px 边框与 3mm 的阴影留白。因此只需保证 alt="avatar" 属性名不变,任何尺寸的图片都会被自动裁剪为圆形并置于简历右上角。
  • 主题样式 styles/classic/vscode.css 会在此基础上微调头像位置(top: -1mm; right: -2mm)。

Obsidian 使用注意:Obsidian 无法识别以 HTML 形式插入的本地图片,若你后续要在 Obsidian 中使用同一模板,推荐先把图片上传为链接再插入。

3.3 章节条目:<div alt="entry-title"> 的职责

教育、工作、项目经历的每个条目都使用同一套结构:

<div alt="entry-title">
    <h3>Software Engineer - OctoConnect Inc., Octoland</h3>
    <p>March 2008 - July 2009</p>
</div>

Led a team project to create a social networking platform.

- Designed octopus-inspired user profiles ...
- Integrated OAuth authentication ...
  • 该 div 由样式 styles/main.css 中的 .entry-title, div[alt="entry-title"] 规则接管:display: flex; justify-content: space-between; align-items: center,即“左侧是机构/职位名(h3),右侧是时间段(p)”,两端对齐、垂直居中。
  • 段落负责概述职责,无序列表 - 负责展开 2~4 条量化成果或技术亮点。列表中 ul 使用 list-style-type: '\2022'(圆点符号)且加粗显示 marker,行距继承 --line-height。
  • 模板中专业技能(Skills)则纯用列表呈现,无需 div 结构,可根据内容量自由增删。

四、图标体系:内置 iconfont 的正确打开方式

模板各章节标题中的符号(如 Education 前的 、Work Experience 前的 、Projects 前的 、Skills 前的 )并非 Emoji,而是 LapisCV 内置图标字体(fonts/iconfont.ttf)中的字形。使用方法是在标题文字前加上转义 Unicode:

## &#xe80c; Education

样式表(如 styles/classic/vscode.css)通过 @font-face 注册了名为 “LapisCV Icon” 的字体,并让它作为标题、段落字体的前缀回退项(如 font-family: "LapisCV Icon", var(--title-font)),从而保证这些编码能被渲染为对应图标。

仓库目前支持的图标及对应转义 Unicode 如下表(图标字形可对照 README 中的图标列表查看):

图标含义(章节) Escaped Unicode 图标含义(章节) Escaped Unicode
电话(信息栏) &#xe60f; 邮箱(信息栏) &#xe7ca;
链接(信息栏) &#xe600; 工作经历 &#xe618;
教育经历 &#xe80c; 专业技能 &#xecfa;
荣誉奖项 &#xe69c; 学术研究 &#xe6b3;
开源贡献 &#xe8ae; 证书资质 &#xe782;
志愿服务 &#xe8b4; 语言能力 &#xe603;
培训经历 &#xe8b5; 项目经历 &#xe638;
项目经历 &#xe635; 兴趣爱好 &#xe673;

实际操作时,直接复制表中第二列或第四列的转义 Unicode 粘贴到标题位置即可。如果某个图标在你的编辑器中没有显示,请确认主题样式已正确加载(字体文件随 Release 一并提供)。

五、分页与页码

5.1 手动分页

模板在需要分页的位置插入一条水平分隔线即可强制分页:

---

该技巧依赖 styles/main.css 中的打印规则:@media print 下 hr 被设置为 page-break-after: always; visibility: hidden——即分隔线在打印时不可见,但其后内容强制另起一页,同时在屏幕上显示为一条灰色分割线(border-top: 2px solid #dae3eac9),便于编辑时识别分页位置。

5.2 页码配置

VSCode 下的页码由 Markdown PDF 插件的页眉页脚模板控制,修改 .vscode/settings.json:

"markdown-pdf.displayHeaderFooter": true,
"markdown-pdf.headerTemplate": "<div></div>",
"markdown-pdf.footerTemplate": "<div style=\"font-size: 9px; margin: 0 auto;\"> <span class='pageNumber'></span> / <span class='totalPages'></span></div>",
  • displayHeaderFooter: true 开启页眉页脚;
  • headerTemplate 留空 <div></div> 表示不显示页眉;
  • footerTemplate 用插件提供的 pageNumber 与 totalPages 两个 span 拼出 “当前页 / 总页数” 的页码格式(字号 9px、居中)。

(Typora 平台则是在 设置 > 导出 > PDF 中直接设置页脚模板,例如 ${pageNo} / ${totalPages};Obsidian 本身不支持直接添加页码,可自行安装插件实现。)

六、页边距调整

VSCode 下有两种方式:

  1. 直接改配置:修改 .vscode/settings.json 中 markdown-pdf.margin 相关项,例如:
"markdown-pdf.margin.top": "13mm",
"markdown-pdf.margin.bottom": "13mm",
"markdown-pdf.margin.right": "15mm",
"markdown-pdf.margin.left": "15mm",
  1. 通过 GUI 修改:打开 VSCode 设置,选中 Workspace 标签页,搜索 Markdown-pdf › Margin,分别修改四边边距。

Typora:在 设置 > 导出 > PDF > 页边距 中配置(官方推荐 A4 纸、上下 13mm、左右 15mm)。

Obsidian:修改样式文件中的 --file-margins 变量(见下文自定义样式一节)。

七、自定义样式:CSS 变量驱动的主题调优

LapisCV 的排版细节全部沉淀为 CSS 自定义属性(变量),修改即可全局生效。对应编辑器的样式文件位置:

  • Typora:设置 > 外观 > 打开主题文件夹 中的 lapis-cv.css / lapis-cv-serif.css;
  • VSCode:解压目录内 lapis-cv/styles/ 下的 lapis-cv.css / lapis-cv-serif.css;
  • Obsidian:设置 > 外观 > CSS 代码片段 中开启对应片段。

仓库源码中 VSCode 主题变量的实际定义位于 styles/classic/vscode.css(经典主题)与 styles/serif/vscode.css(Serif 主题,v2.0.0 新增),可对照修改。常用变量及其含义如下:

/* Custom Configs */

/* 基础配置 */
--text-size: 10pt;                      /* 正文字号 */
--line-height: 1.8;                     /* 正文行高 */
--avatar-width: 29mm;                   /* 头像宽度(圆形头像直径) */

/* 字体配置 */
--h1-size: 16pt;                        /* 一级标题(姓名)字号 */
--h2-size: 12pt;                        /* 二级标题(章节)字号 */
--h3-size: 10.5pt;                      /* 三级标题(条目机构名)字号 */
--blockquote-size: 9.3pt;               /* 联系信息栏字号 */

--text-font: 'SourceHanSansCN';         /* 正文字体(思源黑体) */
--title-font: 'SourceHanSerifCN';       /* 标题字体(思源宋体,Serif 主题生效) */
--link-font: 'JetBrainsMono';           /* 链接字体(等宽) */
--code-font: 'JetBrainsMono';           /* 代码字体(等宽) */

/* 色彩 */
--color-accent: #4870ac;                /* 主题色:图标、h2 下划线等 */
--text-normal: #353a42;                 /* 正文颜色,若需打印请改为纯黑(如 #000) */
--link-color: #0563c1;                  /* 链接颜色 */

几点说明:

  • 主题色 --color-accent 会同时作用于信息栏图标(styles/main.css 中 .icon, span[alt="icon"] 取 var(--color-accent))、H2 标题颜色及其下划线(h2 { border-bottom: 1px solid color-mix(...) });
  • 头像尺寸 修改 --avatar-width 即可等比缩放圆形头像;
  • 字体切换:--text-font 默认思源黑体,Serif 主题将 --title-font 改为思源宋体并在 @font-face 中引入了 SourceHanSerifCN-Bold.ttf,呈现更偏正式的衬线风格;
  • 修改后部分样式需要重启编辑器才能生效(如字体、字号等由渲染层缓存的项目);
  • 若内容体量变化导致页面过密或过空,优先调整 --line-height、--text-size 与分页线位置,而非逐条微调边距。

八、从源码看渲染链路:模板、主样式与主题如何协作

理解 LapisCV 的渲染链路有助于排查样式问题。三个角色各司其职:

  1. 模板文件(templates/vscode/template-en.md)只负责内容与语义标记(alt="icon"、alt="avatar"、alt="entry-title");
  2. 主样式(styles/main.css)负责与编辑器无关的通用排版:标题、列表、头像、引用块、链接、打印分页等,全部通过 var(--xxx) 引用变量;
  3. 主题样式(styles/classic/vscode.css / styles/serif/vscode.css)负责声明变量取值、@font-face 字体注册,以及针对 VSCode 屏幕预览的微调(如 @media screen 下页面加阴影、内边距 20mm、背景色跟随编辑器主题)。

在 VSCode 中,主题的加载顺序由 .vscode/settings.json 的 markdown.styles 数组控制,需要同时加载 main.css 与主题 css:

"markdown.styles": [
    "./lapis-cv/styles/main.css",
    "./lapis-cv/styles/lapis-cv.css",   // 经典主题;Serif 主题改为 lapis-cv-serif.css
],

从 Makefile 的组装逻辑可见,build/vscode 产物正是将上述文件按该顺序合并生成,确保变量先声明后使用。若预览时图标、字体或颜色缺失,请优先检查:markdown.styles 路径是否指向解压目录内的真实文件、main.css 是否在主题 css 之前加载、以及其他插件是否改写了 Markdown 渲染样式。

九、快速上手清单

在 VSCode 中使用 LapisCV 模板制作简历的最小步骤如下:

  1. 下载并解压 Release,在 VSCode 中打开解压目录;
  2. 安装 Markdown PDF 插件;
  3. 打开 templates/vscode/template-en.md(或中文版 templates/vscode/template-cn.md),点击右上角预览图标;
  4. 替换姓名、联系信息、头像、教育/工作/项目经历与技能列表;
  5. 按需调整章节图标、插入 --- 分页、在 .vscode/settings.json 配置页码与边距;
  6. 右键选择 “Markdown PDF - Export (pdf)” 导出 PDF,检查分页与边距后投递。

整个流程无需触碰任何 HTML/CSS 布局代码,排版细节均通过模板约定与 CSS 变量完成,内容维护成本极低;配合 Git 进行版本管理,简历的每一次修改都可追踪回溯。若需要从源码构建 Release 文件夹,可参照 README.md 中的 make 命令在仓库内执行构建。

登录后查看全文
LapisCV