MD2Resume

An Obsidian plugin to convert markdown into a nice-looking resume!

Overview

I've spent far too many hours just trying to make my resume look right. No matter if I'm in Google Docs or Word, the formatting is always off. You know what's consistent? Markdown. That's why I built MD2Resume.

Installation

Note: This project has been approved as a community plugin! Now you can install it directly from the community plugin page! https://community.obsidian.md/plugins/md-to-resume

1. Navigate to the plugins directory of your Obsidian vault

cd ~/VAULT/PATH/.obsidian/plugins/

2. Clone the project

git clone https://github.com/BrohdeXC/MD2Resume

3. Navigate to the community plugins tab in Obsidian and if you don't have community plugins enabled, do that now

   

4. Refresh the plugins and enable it

   

Quick Usage

1. Grab the MD2Resume-Template.md file and move it into your vault, rename it as desired

mv ~/VAULT/PATH/.obsidian/plugins/MD2Resume/MD2Resume-Template.md ~/VAULT/PATH/RESUMES/YourResume.md

2. While looking at your file, press the "Preview Resume" button on the left panel

   

3. Make that resume!

4. Once you're ready to export, press the "Export as PDF" button above the preview

   

5. Select the destination for the file and give it a name, now you're ready to submit that application!

   

Detailed Usage

Properties

The properties are values that show up at the top of the resume. This includes name, contact information, and a quick bio. These automatically generate hyperlinks in the PDF. Currently supported properties include:

• name - Your Name
• contact_email - Your Email
• contact_phone - Your Phone Number
• contact_website - Your Website
• contact_linkedin - Your LinkedIn
• contact_github - Your GitHub
• header - Your bio

Body

Sections: ## Section Name
Any name; freely defined.

Job entries: ### Title | Date Range
The | separator triggers job formatting with a dot-leader between title and date. An optional italicized subtitle on the next line (*Company, Location*) is supported.

Project entries: ### Title: Subtitle
The : separator splits the title for inline subtitle styling. Without a : or |, it renders as a plain titled entry.

Bullets: - or * bullets
Works at section level (bare bullets) and inside entries.

Tag/plain-text lines: Any non-heading
Non-bullet plain text in a section body becomes a tag-list item (useful for certifications, tools, etc.).

Comments

Single hashes # and 4x hashes #### don't generate text in the PDF. This is so they can be used as comments and logic separators that you might not want to show in the resume itself.