YAMLResume v0.8 发布：支持 Markdown 输出

[xiaohanyu]

Hello：

距离前次 YAMLResume 更新 过了两个月，今天带来了 YAMLResume v0.8 ，主要更新是支持多布局/多输出端，特别是对 Markdown 的输出支持。

[]

在 YAMLResume v0.7 之前，YAMLResume 的编译流程是线性的：YAML -> LaTeX -> PDF。

PDF 毫无疑问是求职投递的黄金标准，但也有很多局限性：

1. 对 LLM 不友好：想让 ChatGPT 帮你改简历？把 PDF 复制进去往往格式错乱，
2. Web 展示不便：想把简历挂在自己的博客（ Hugo/Next.js ）上？通常只能挂个 PDF 下载链接，或者手写一份 HTML/Markdown ，导致维护两份数据。
3. 版本对比困难：Git diff 一个二进制 PDF 文件没有任何意义。

为了解决这些问题，我们在 v0.8 中重构了核心架构，引入了 多布局（ Multiple Layouts ） 支持，并首发了 Markdown 输出引擎。

现在，你可以在 resume.yml 中定义多个输出布局。只需运行一次 yamlresume build，就能同时生成 PDF 和 Markdown 文件。

配置示例：

layouts:
  - engine: latex   # 传统的 PDF 生成引擎
    template: moderncv-banking
  - engine: markdown # 新的 Markdown 生成引擎

Markdown 输出的优势

1. LLM 友好（ Killer Feature ） 这是我们引入 Markdown 的最大动力。生成的 resume.md 结构清晰（标题、列表），是 LLM 的完美输入。 你可以直接把生成的 Markdown 扔给 ChatGPT/Claude：

   • “根据这个 JD ，帮我优化一下我的 resume.md 中的项目描述。”
   • “提取我的技能点，帮我写一封 Cover Letter 。” 效果比直接丢 PDF 好太多。

2. 自动化个人主页 如果你有基于 Markdown 的博客（ Next.js, Hugo, Gatsby 等），现在可以实现自动化流： 改 YAML -> Build -> 自动更新博客的 /about 页面。单一数据源，多处分发。

3. Git Diffs Markdown 是纯文本。当你修改了一段工作经历，Git diff 会清晰地显示文本变化。这对于 Code Review 简历非常有帮助。

4. 通用性 有了 Markdown ，你可以通过 Pandoc 轻松转成 Word (.docx)、HTML 或其他任何格式，应付那些强制要求 Word 格式的猎头。

快速上手

YAMLResume 基于 Node.js ，支持全平台。

# 安装
npm install -g yamlresume
# 或者使用 Homebrew
brew install yamlresume

# 初始化一个模版
yamlresume new my-resume.yml

# 构建（同时生成 PDF 和 Markdown ）
yamlresume build my-resume.yml

下一步计划

我们正在开发 HTML 布局引擎。目标是生成一个单文件、响应式、SEO 友好的 HTML 简历，体验接近 PDF 但原生适配移动端阅读。

欢迎大家试用并反馈！

• 官网: https://yamlresume.dev
• GitHub: https://github.com/yamlresume/yamlresume
• 详细发布日志: https://yamlresume.dev/zh-cn/blog/markdown-output
• Demo: https://asciinema.org/a/759578

补充 YAMLResume 的一些 showcases：

https://github.com/yamlresume/yamlresume/discussions/50

不过 Github 上的例子都还是 yamlresume v0.7 的版本，需要把 `layout` 升级 `layouts` 一下。

[xinyu391]

命令行下写简历，小众需求吧
不能可见即可得，有点开箱盲盒的意思。
可以做成，左侧编辑，右侧预览的页面应用。

[xiaohanyu]

@xinyu391 左侧编辑，右侧预览的功能，有的哈哈

YAMLResume v0.7 中增加了 dev mode ，这样在 vs code 中，开一个 `npm run dev`，然后左侧编辑，右侧就可以预览生成的 pdf 了，准实时的： https://yamlresume.dev/zh-cn/blog/dev-mode

当然，非技术人员，可以试试我的商业产品呀： https://ppresume.com

[Razio]

单纯说语法，实在不喜欢 yaml 的语法，不如 toml 清晰可靠

[xiaohanyu]

@Razio 我个人对 YAML VS toml 的语法没有特别的倾向，但是 YAML 确实是有一些 edge cases 需要特别注意一下。

不过对于我的这个场景呢，YAML 的好处在于可以完全复用 JSON schema 的生态，所以可以实现一些比较好用的 auto-completion 自动补全和 validation 数据验证。

一些 demo： https://yamlresume.dev/zh-cn/blog/yamlresume-compiler

可以帮助规避一些常见的低级错误，比如非法的 URL/email 这些。

[xiaohanyu]

@Razio 不知道 toml 中有没有类似于 JSON schema 的工具？

[MIUIOS]

果然是程序员搞的产品，好重的技术味道