Manage your resume information in a central YAML file and then export it into different formats and themes.
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.




Resume2 is a command line tool to manage your resume from a central data (YAML) file. Why YAML? Because no one should ever have to write an XML file.

Right now it will process a Markdown file and merge the data into it. From there you can create a PDF or HTML via TextMate. Plenty of refinements before I even contemplate labeling it ready for public consumption.


sudo gem install n3bulous-resume2 --source=


Initial instructions:

  1. Create a resume.yml file, nesting your data as appropriate to capture the data, basically a collection of hashes and arrays:

     	given: Kevin
     	surname: McFadden
         - [ "Databases", "MySQL, Oracle 8i/9i, Informix 7, PostgreSQL" ]
         - [ "Programming", "Ruby, PHP, Java, BASH, Forth, Perl, C, C++, Objective C" ]
         - [ "Operating Systems", "Linux, Solaris, OS X, HP-UX, MS Windows" ]
         - [ "Miscellaneous", "Scrum, XP, Subversion, Git, CVS, XHTML, XML, XML-RPC, AJAX" ]
  2. Create a Markdown template to style the resume.

     <div style="font-style: bold; font-size: 1.4em; text-align: center"><%= "#{name.given} #{name.surname}" %></div>
     <div style="text-align: center">
     <%= "#{address.street}, #{}, #{address.state}, #{address.postal.to_s}" %><br/>
     <%= "#{} | #{}" %><br/>
     <%= contact.urls.linkedin %><br/>
     <% skills.brief.each do |a| %>
     		<th><%= a[0] %></th>
     		<td><%= a[1] %></td>
     <% end %>
  3. Combine the two with resume2 to generate the Markdown output.

     resume2 markdown resume.markdown.erb resume.yml > resume.markdown
  4. Right now I'm using MultiMarkDown with TextMate to generate the HTML/PDF, but I'm aiming to streamline the process and avoid using TextMate in my process. MultiMarkDown supports CSS allowing for better styling.

MultiMarkDown is a Perl script, so the final version may require its installation...


  • .resume2rc config file to specify defaults for resume file paths, resume.yml, and theme.
  • Refine
  • Refactor generator to handle the different outputs.
  • Support direct, PDF output.
  • Support RTF templates.
  • Support XHTML, Markdown, and text templates. (essentially done, needs cleanup)
  • Full examples.


Resume2 is free software; it is released under a BSD-style license that allows you to do as you wish with it as long as you don’t attempt to claim it as your own work.

By downloading this software, you agree to NOT blame the author if you fail to get a job, fail to apply for a job, or continue living in your mother's basement or garage. The author is also not responsible for any typos, either mine or yours. Use at your own risk. Software is not approved for use in mission critical systems.