DEV Community

Do you have a markdown resume?

Jasterix on August 11, 2020

What information do you include in your markdown resume that's not in your one page PDF resume?

Both of mine are the same for now, but I'm exploring ways to make the most of the markdown file format.

Collapse
 
davidgerva profile image
David

Not sure if you are talking about markdown because you actually want it in markdown format (if this is the point, I don't get the pros to have the resume in markdown).
If you're just looking for an "online" easy to update version of your resume I've found an awesome service that I use: registry.jsonresume.org/davidgerva

That is my resume and it is in a simple text-format in a GitHub gist. The service just reads the last version of that file and render your resume.
Here is the site if you may need: jsonresume.org/

Collapse
 
jasterix profile image
Jasterix

Thanks for sharing. I like the markdown resume because I can take advantage of the format to show more. For example, Maria in the comments below suggested including a gif for each project

Collapse
 
stereoplegic profile image
Mike Bybee • Edited

JSON resume is awesome, @davidgerva. I do wish it had more options in the standard schema, but you can do super cool things with it as a data source. If you feed it to a simple template, that can give you basic HTML you can convert to docx and markdown with pandoc (see my top-level comment about formatting limits for getting through Applicant Tracking Systems).

@jasterix you actually get more control over formatting and styling the pdf and web versions of your resume with JSON, and see the above paragraph for how you can still convert it to markdown via a separate simple HTML output. It's more steps, but awesome control.

Collapse
 
svasylenko profile image
Serhii Vasylenko

I keep the markdown version as the 'single source of truth' :-D and use it to render html and pdf versions.
And this can be even more fancy if you keep it on GitHub :-)
Check it out:
github.com/vasylenko/serhii.vasyle... - this is a source
serhii.vasylenko.info/cv/ - and this is the compiled version (also hosted on GitHub)
Plus you can control the rendering for printed version via CSS.

the idea itself is not new, here is some how-to's: mszep.github.io/pandoc_resume/ and elipapa.github.io/markdown-cv/

Collapse
 
jasterix profile image
Jasterix

This is great- thanks! I'll check out the links in detail

Collapse
 
stereoplegic profile image
Mike Bybee • Edited

Keep a markdown source, making use of heading, paragraph, link, and unordered list tags, and you can convert that to .docx with pandoc (do it twice, so you can tweak the styles pane on the first and use it as a template for future conversions). Set up a static site generator, style that with as much bling as you like (keeping it professional, obviously), and you can convert that to .pdf from puppeteer or your browser's print page functionality (@media print CSS styles may come in handy).

Avoid more complex formatting for the .docx version, as many ATS (applicant tracking systems) choke on images, tables, etc.

Collapse
 
scrabill profile image
Shannon Crabill

I've been thinking about making a markdown version of mine, but I am not sure if I'll need it.

I may do a master markdown CV/resume that I can pull from as needed. I seen to misplace items when I put them elsewhere.

Collapse
 
jasterix profile image
Jasterix

I think it's worth it. I recently applied to a role that specifically asked for markdown resume on github

Collapse
 
andrewbaisden profile image
Andrew Baisden

I don't have a markdown resume but I think that it would be cool to create one. However at the end of the day we are giving our resume to recruiters and they only work with Microsoft office 🤣

Collapse
 
jasterix profile image
Jasterix

lol funny enough, Microsoft asked for a markdown resume. But I really like the format, especially when applying to programs and conference scholarships. Instead of a link to the google doc, I can share a link to the gist

Collapse
 
andrewbaisden profile image
Andrew Baisden

Ok thats a really good usage for it. Do you have a separate Markdown and Word doc resume? Or do you just have a version in Markdown that you can export as Word?

Thread Thread
 
jasterix profile image
Jasterix

Yeah, I have a one pager in Google Docs that I update for every role and download as a PDF. I also have the markdown resume in a private gist

Collapse
 
santiagocodes profile image
Maria del Carmen Santiago

With markdown you can include a GIF (maybe of your top projects?).

Collapse
 
jasterix profile image
Jasterix

Great idea. I definitely want to take advantage of the medium to show more on my resume

Collapse
 
supercodingninja profile image
Frederick Thomas
Collapse
 
jasterix profile image
Jasterix

okay wow this is so interactive and interesting. I was immediately sucked into wanting to read more. Also love how it carries over to your GitHub profile 😁

Collapse
 
kavyaj profile image
kavyaj

Markdown resume creator:
resumey.pro/

Collapse
 
jasonpatrickellykrause profile image
Jason Krause

Image description

Collapse
 
kavyaj profile image
kavyaj

Hey Jason,
How can I help? :)

Collapse
 
jkimexploring profile image
JkImExploring

I have one from applying to the Microsoft Leap program and it's more project-based and a bit longer. I still want to make a normal project-based resume.

Collapse
 
jasterix profile image
Jasterix

same! I made one for the Microsoft Leap program

Collapse
 
garymeng profile image
Gary Meng • Edited

I created my own resume with Markdown on Resumis.
It is really easy to edit, save to github, customize template and export to PDF.