LapisCV VSCode 简历模板指南:用 Markdown 在 VSCode 中快速制作专业简历
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”),其结构共分六个部分:
- 姓名标题区(H1):简历最顶部的
# The Octocat标题; - 联系信息栏(blockquote):通过引用块排版电话号码、邮箱、个人链接;
- 头像(HTML
<img>):右上角圆形头像; - 教育经历(Education);
- 工作经历(Work Experience);
- 项目经历(Projects);
- 专业技能(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"></span> `(123)456-7890`   <span alt="icon"></span> `octocat@github.com`   <span alt="icon"></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均居中。联系信息中的  (全角空格)用于在电话、邮箱、链接之间制造横向间隔。 - 电话与邮箱用反引号包成行内代码,链接用 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:
##  Education
样式表(如 styles/classic/vscode.css)通过 @font-face 注册了名为 “LapisCV Icon” 的字体,并让它作为标题、段落字体的前缀回退项(如 font-family: "LapisCV Icon", var(--title-font)),从而保证这些编码能被渲染为对应图标。
仓库目前支持的图标及对应转义 Unicode 如下表(图标字形可对照 README 中的图标列表查看):
| 图标含义(章节) | Escaped Unicode | 图标含义(章节) | Escaped Unicode |
|---|---|---|---|
| 电话(信息栏) |  |
邮箱(信息栏) |  |
| 链接(信息栏) |  |
工作经历 |  |
| 教育经历 |  |
专业技能 |  |
| 荣誉奖项 |  |
学术研究 |  |
| 开源贡献 |  |
证书资质 |  |
| 志愿服务 |  |
语言能力 |  |
| 培训经历 |  |
项目经历 |  |
| 项目经历 |  |
兴趣爱好 |  |
实际操作时,直接复制表中第二列或第四列的转义 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 下有两种方式:
- 直接改配置:修改
.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",
- 通过 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 的渲染链路有助于排查样式问题。三个角色各司其职:
- 模板文件(
templates/vscode/template-en.md)只负责内容与语义标记(alt="icon"、alt="avatar"、alt="entry-title"); - 主样式(styles/main.css)负责与编辑器无关的通用排版:标题、列表、头像、引用块、链接、打印分页等,全部通过
var(--xxx)引用变量; - 主题样式(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 模板制作简历的最小步骤如下:
- 下载并解压 Release,在 VSCode 中打开解压目录;
- 安装 Markdown PDF 插件;
- 打开
templates/vscode/template-en.md(或中文版 templates/vscode/template-cn.md),点击右上角预览图标; - 替换姓名、联系信息、头像、教育/工作/项目经历与技能列表;
- 按需调整章节图标、插入
---分页、在.vscode/settings.json配置页码与边距; - 右键选择 “Markdown PDF - Export (pdf)” 导出 PDF,检查分页与边距后投递。
整个流程无需触碰任何 HTML/CSS 布局代码,排版细节均通过模板约定与 CSS 变量完成,内容维护成本极低;配合 Git 进行版本管理,简历的每一次修改都可追踪回溯。若需要从源码构建 Release 文件夹,可参照 README.md 中的 make 命令在仓库内执行构建。