Markdown Resume

本项目用于在 VS Code 中预览与导出中文简历（resume.md），并统一使用 .vscode/resume-unified.css 保持样式一致。

目录结构

• resume.md：简历正文
• .vscode/resume-unified.css：预览与导出共用样式
• .vscode/settings.json：VS Code 项目设置
• Misans/ttf/：MiSans 字体文件

Linux 安装 MiSans 字体

推荐先安装字体，再进行 PDF 导出，避免中文字体回退导致版式变化。

方式 1：仅当前用户安装（推荐）

在项目根目录执行：

mkdir -p ~/.local/share/fonts/MiSans
cp Misans/ttf/*.ttf ~/.local/share/fonts/MiSans/
fc-cache -f -v

验证字体是否可用：

fc-list | grep -i "misans"

方式 2：系统全局安装

sudo mkdir -p /usr/local/share/fonts/MiSans
sudo cp Misans/ttf/*.ttf /usr/local/share/fonts/MiSans/
sudo fc-cache -f -v

依赖的 VS Code 插件

必需插件

1. Markdown PDF（扩展 ID：yzane.markdown-pdf）
   • 用途：将 resume.md 导出为 PDF
   • 本项目已在 .vscode/settings.json 中配置：
     • markdown-pdf.styles
     • markdown-pdf.includeDefaultStyles
     • markdown-pdf.displayHeaderFooter

内置能力（无需安装）

1. VS Code 内置 Markdown 预览
   • 本项目通过 markdown.styles 引入 .vscode/resume-unified.css

一键安装命令

code --install-extension yzane.markdown-pdf

使用方式

1. 预览简历

• 打开 resume.md
• 使用命令面板执行 Markdown: Open Preview to the Side

2. 导出 PDF

• 在 resume.md 编辑器中右键
• 选择 Markdown PDF: Export (pdf)

导出成功后，默认会在同目录生成 PDF 文件。

常见问题

导出 PDF 后中文字体不一致

• 先确认 fc-list | grep -i misans 能查到字体
• 关闭并重开 VS Code 后重试导出
• 如果仍有问题，确认系统中无同名冲突字体

命令行找不到 code

可在 VS Code 中打开命令面板执行：

• Shell Command: Install 'code' command in PATH

然后重开终端再执行扩展安装命令。

预览