If you’re looking for a way to modernize your resume while maintaining simplicity, you’ve come to the right place. The Markdown-CV tool allows you to craft a beautiful curriculum vitae in plain text that can be easily converted to both HTML and PDF formats using CSS. This guide will walk you through the steps of creating, customizing, and distributing your CV.

Why Use Markdown for Your CV?

Markdown provides an efficient way to manage your CV. It’s lightweight, easy to read, and enables quick updates. For more insights into transitioning to Markdown, check out the blog post on why I switched to Markdown for my CV.

Customization

Getting started is a breeze. Simply fork the markdown-cv repo and edit the index.md file directly in GitHub. Here’s a quick visualization:

1.Fork the repository
2. Edit index.md
3. Add your skills, jobs, and education

Distribution Options

Once your CV is ready, it’s time to share it! There are two straightforward methods to distribute your CV:

I. Use GitHub Pages to Publish It Online

1. Delete the existing gh-pages branch from your fork. This branch typically contains only the webpage.
2. Create a new branch called gh-pages.
3. Navigate to yourusername.github.io/markdown-cv to access your live CV.

Any future changes should be made on the gh-pages branch to ensure they reflect immediately on GitHub Pages.

II. Build It Locally and Print a PDF

1. To install Jekyll, run gem install bundler jekyll in your command line.
2. Clone your fork of markdown-cv to your local machine.
3. Run jekyll serve to render your CV at http://localhost:4000.
4. Edit the index.md file and see changes live in your browser.
5. To print a PDF, press ⌘ + P; the CSS media queries ensure great styling for both print and web.

Styling Your CV

The Markdown-CV comes with two styles:

• kjhealy: The original default, inspired by kjhealy’s vitatemplate.
• davewhipp: A tweaked version with bigger fonts and right-aligned dates.

To change the default style, modify the variable in the _config.yml file. Additional CSS contributions are always welcome!

Analogous Explanation of the Code

Think of building your CV using Markdown-CV as constructing a house. Each feature of the house (your skills, jobs, and education) is outlined in your blueprint (the index.md file). The Markdown-CV repository is your toolset, full of everything you need to build and furnish your home.

Publishing your house (CV) online with GitHub Pages is analogous to showing it off on the internet. Just like clearing the construction site (deleting the existing branch) and redecorating (creating a new branch), you prepare your space to welcome guests.

Troubleshooting Ideas

If you encounter any issues during this process, consider the following troubleshooting tips:

• Ensure you have the correct permissions to edit the repository.
• If GitHub Pages isn’t displaying your changes, remember to push your updates to the gh-pages branch.
• For local builds, check for any console errors while running Jekyll.
• Ensure that all links in the index.md file are correctly formatted to avoid broken links.

For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.

Conclusion

Creating a CV using Markdown-CV is not only efficient but also encourages creativity through styling and customization. Start building your professional presence today!

At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.