PHPackages there4/markdown-resume - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Parsing & Serialization](/categories/parsing) 4. / 5. there4/markdown-resume ActiveLibrary[Parsing & Serialization](/categories/parsing) there4/markdown-resume ====================== Markdown Resume Generator 2.3.2(7y ago)1.8k37512[18 issues](https://github.com/there4/markdown-resume/issues)[1 PRs](https://github.com/there4/markdown-resume/pulls)MITLessPHP >=7.1 Since Jan 8Pushed 3y ago58 watchersCompare [ Source](https://github.com/there4/markdown-resume)[ Packagist](https://packagist.org/packages/there4/markdown-resume)[ Docs](https://github.com/there4/markdown-resume)[ RSS](/packages/there4-markdown-resume/feed)WikiDiscussions master Synced 2mo ago READMEChangelog (8)Dependencies (16)Versions (12)Used By (0) Markdown Resume Generator [![Build Status](https://camo.githubusercontent.com/d90a94ed1bf8ad09a06aab1b28f7e0517437356bde1642f76b567af36def17fa/68747470733a2f2f7472617669732d63692e6f72672f7468657265342f6d61726b646f776e2d726573756d652e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/there4/markdown-resume)[![nodesource/node](https://camo.githubusercontent.com/ab830face4a4a7f6a81c7fbd529450707f612784120a7cb1a459349d3fe9374e/687474703a2f2f646f636b6572692e636f2f696d6167652f7468657265342f6d61726b646f776e2d726573756d65)](https://registry.hub.docker.com/u/there4/markdown-resume/) ============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================ [](#markdown-resume-generator-) > Convert markdown to HTML and PDF resumes Turn a simple Markdown document into an elegant resume with both a perfect pdf printable format, and a responsive css3 html5 file. You can view a sample at the [blog post for the project](http://there4development.com/blog/2012/12/31/markdown-resume-builder/), or look in examples/output to see sample PDFs. Features -------- [](#features) - Multiple styles to choose from: `modern`, `blockish`, `unstyled`, `readable`, `swissen` *(Fork and add more!)* - PDF generation via [wkhtmltopdf](https://github.com/pdfkit/pdfkit/wiki/Installing-WKHTMLTOPDF) - Responsive design for multiple device viewport sizes - Simple Markdown formatting - Single file deployment (no external stylesheets) - You can now version control and branch your resume. Installation ------------ [](#installation) ### Docker [](#docker) Run those commands in the directory where you put your markdown resume. #### Oneshot command [](#oneshot-command) This is best suited for use in scripts or in CI environments: `docker run -v ${PWD}:/resume there4/markdown-resume md2resume [options] command [arguments]` #### Interactive console [](#interactive-console) This allows you to enter an interactive console where you can easily experiment and run different commands: `docker run -it -v ${PWD}:/resume there4/markdown-resume` ### Local [](#local) 1. Clone the repo `git clone git@github.com:there4/markdown-resume.git` or [Download ZIP](https://github.com/there4/markdown-resume/archive/master.zip) 2. **PHP 7** and **[composer](https://getcomposer.org/download/)** are installed and on your PATH 3. `composer install` inside of the project directory to install dependencies 4. For generating PDF files, you need to install `wkhtmltopdf` - OSX: `brew cask install wkhtmltopdf` via [Homebrew Cask](https://caskroom.github.io/) - Debian: `sudo apt install php7.0-mbstring wkhtmltopdf` - Fedora `sudo dnf install php-mbstring wkhtmltopdf` Usage ----- [](#usage) The two most important commands are the following two. Run them inside the cloned directory ``` ./bin/md2resume html examples/source/sample.md examples/output/ ./bin/md2resume pdf examples/source/sample.md examples/output/ ``` Help ---- [](#help) ``` Markdown Resume Generator version 2.3.0 by Craig Davis Usage: [options] command [arguments] Options: --help -h Display this help message. --quiet -q Do not output any message. --verbose -v|vv|vvv Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug --version -V Display this application version. --ansi Force ANSI output. --no-ansi Disable ANSI output. --no-interaction -n Do not ask any interactive question. Available commands: help Displays help for a command html Generate an HTML resume from a markdown file list Lists commands pdf Generate a PDF from a markdown file stats Generate a word frequency analysis of your resume templates List available templates version Show current version information ``` Examples -------- [](#examples) Choose a template with the -t option. ``` ./bin/md2resume html --template blockish examples/source/sample.md examples/output/ ``` If you want to edit your markdown resume in your editor while watching it update in your browser, run this command: ``` watch ./bin/md2resume html --refresh yes --template modern examples/source/sample.md examples/output/ ``` This makes the build script run periodically, and html document will refresh every two seconds via a meta tag. Open the `./examples/ouput/sample.html` file in your browser, and then just save your markdown document when you want to see a fresh preview. Authoring Your Resume --------------------- [](#authoring-your-resume) Markdown is limited to basic html markup. Follow the `examples/source/sample.md`file as a guideline. This file includes various headers and several nested elements. This allows us to construct a semantic HTML document for the resume, and then use CSS rules to display a nicely formatted resume. Note that because we have very few ways to nest or identify elements that many of the css rules are based on descendant and adjacent selectors. Feature Development ------------------- [](#feature-development) In order to add new commands, you'll need to first install the dependencies via `composer install` After that, you can run the `md2resume_dev.php` file from the command line. Building a Release ------------------ [](#building-a-release) 1. Tag the repo with the new build number. 2. Run `composer build`. 3. Push both the tag and the code. Acknowledgments --------------- [](#acknowledgments) The initial inspiration is from the [Sample Resume Template](http://sampleresumetemplate.net/ "A great starting point"). However, no HTML from that project has been used in this. General layout has been reused, and media queries have been added. It's a nice template, and if you are a more comfortable with html than markdown, you should use it. Changelog --------- [](#changelog) - **2.3.1** : Fix embedded images in PDF generation with Docker [@danielklim](https://github.com/danielklim) - **2.3.0** : Add Docker support to ease the installation process [@spawnia](https://github.com/spawnia) - **2.2.0** : Dropped phar file distribution, removed Pake and migrated to composer commands - **2.1.0** : Dropped PHP5 support - **2.0.12** : Added new `Roboto` template from [@ejwaibel](https://github.com/ejwaibel) - **2.0.10** : Updated spacing in moder template with commites from [@501st-alpha1](https://github.com/501st-alpha1) - **2.0.9** : Updated Modern template with improved spacing. Update parsing of `--template` option to close [issue #7](https://github.com/there4/markdown-resume/issues/7) - **2.0.8** : New `readable` theme contributed by @ahmadnazir, minor refactor to support a /links directory - **2.0.7** : Update composer to use `sunra/php-simple-html-dom-parser` this appears to be better maintained and more popular to [close #27](https://github.com/there4/markdown-resume/issues/27) - **2.0.6** : Fix empty template list from phar file to [close #24](https://github.com/there4/markdown-resume/issues/24) - **2.0.5** : Remove default value for the `--refresh` option to [close #22](https://github.com/there4/markdown-resume/issues/22) - **2.0.4** : Fix path resolution problem with absolute paths to [close #16](https://github.com/there4/markdown-resume/issues/16) - **2.0.3** : Add optional duration to the `--refresh` option to [close #15](https://github.com/there4/markdown-resume/issues/15) - **2.0.2** : Add new dependency check for `mbstring` to [close #20](https://github.com/there4/markdown-resume/issues/20) - **2.0.1** : Add new `swissen` template with Helvetica styling [@beautifulcode](https://github.com/beautifulcode) - **2.0.0** : Complete rewrite with the [symfony console component](http://symfony.com/doc/current/components/console/introduction.html). Deployment is now done with a compiled phar file, and development dependencies are managed with composer. - **0.9.0** : Add composer and update README with new changelog - **0.8.8** : Add Chinese text example [@ishitcno1](https://github.com/ishitcno1) - **0.8.7** : Update pdf formatting of the modern template [@roleary](https://github.com/roleary) - **0.8.6** : Fix output path [@abhikandoi2000](https://github.com/abhikandoi2000) - **0.8.5** : Fix [issue #2](https://github.com/there4/markdown-resume/issues/2) - **0.8.4** : Correct chmod and add parameter for output directory [@kevinxucs](https://github.com/kevinxucs) - **0.8.2** : Update build script and add refresh command option - **0.8.1** : Updating formatting of initial templates - **0.8** : Initial Release to Public ### Health Score 41 — FairBetter than 89% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity36 Limited adoption so far Community35 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 72.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~281 days Recently: every ~92 days Total 7 Last Release 2756d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/06719ba09ce20c0774f7b29346b41890f497cb06252f3b8b701fd0df32abd082?d=identicon)[craig-davis](/maintainers/craig-davis) ![](https://www.gravatar.com/avatar/ef78f0ca3100de38d3af37b825048ff460685d9aa49ff866e3d6fe6b248eaef9?d=identicon)[there4](/maintainers/there4) --- Top Contributors [![craig-davis](https://avatars.githubusercontent.com/u/9907304?v=4)](https://github.com/craig-davis "craig-davis (106 commits)")[![ahmadnazir](https://avatars.githubusercontent.com/u/527355?v=4)](https://github.com/ahmadnazir "ahmadnazir (7 commits)")[![spawnia](https://avatars.githubusercontent.com/u/12158000?v=4)](https://github.com/spawnia "spawnia (4 commits)")[![asbjornu](https://avatars.githubusercontent.com/u/12283?v=4)](https://github.com/asbjornu "asbjornu (4 commits)")[![501st-alpha1](https://avatars.githubusercontent.com/u/676533?v=4)](https://github.com/501st-alpha1 "501st-alpha1 (3 commits)")[![danielklim](https://avatars.githubusercontent.com/u/956111?v=4)](https://github.com/danielklim "danielklim (3 commits)")[![aleksandrbogdanov](https://avatars.githubusercontent.com/u/10163904?v=4)](https://github.com/aleksandrbogdanov "aleksandrbogdanov (3 commits)")[![molecule](https://avatars.githubusercontent.com/u/1158284?v=4)](https://github.com/molecule "molecule (3 commits)")[![kevinxucs](https://avatars.githubusercontent.com/u/1533879?v=4)](https://github.com/kevinxucs "kevinxucs (2 commits)")[![jake-low](https://avatars.githubusercontent.com/u/5893857?v=4)](https://github.com/jake-low "jake-low (2 commits)")[![oflannabhra](https://avatars.githubusercontent.com/u/702042?v=4)](https://github.com/oflannabhra "oflannabhra (2 commits)")[![tribela](https://avatars.githubusercontent.com/u/5047683?v=4)](https://github.com/tribela "tribela (1 commits)")[![abhikandoi2000](https://avatars.githubusercontent.com/u/1875434?v=4)](https://github.com/abhikandoi2000 "abhikandoi2000 (1 commits)")[![bebound](https://avatars.githubusercontent.com/u/2227874?v=4)](https://github.com/bebound "bebound (1 commits)")[![doew](https://avatars.githubusercontent.com/u/39424676?v=4)](https://github.com/doew "doew (1 commits)")[![ishitcno1](https://avatars.githubusercontent.com/u/3647573?v=4)](https://github.com/ishitcno1 "ishitcno1 (1 commits)")[![johnpneumann](https://avatars.githubusercontent.com/u/387735?v=4)](https://github.com/johnpneumann "johnpneumann (1 commits)")[![M5oul](https://avatars.githubusercontent.com/u/4758871?v=4)](https://github.com/M5oul "M5oul (1 commits)")[![tigerclaw-az](https://avatars.githubusercontent.com/u/2830686?v=4)](https://github.com/tigerclaw-az "tigerclaw-az (1 commits)") --- Tags HTML5markdownresume ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/there4-markdown-resume/health.svg) ``` [![Health](https://phpackages.com/badges/there4-markdown-resume/health.svg)](https://phpackages.com/packages/there4-markdown-resume) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M647](/packages/sylius-sylius)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M152](/packages/sulu-sulu)[simplesamlphp/simplesamlphp A PHP implementation of a SAML 2.0 service provider and identity provider. 1.1k12.4M192](/packages/simplesamlphp-simplesamlphp)[prestashop/prestashop PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers. 9.0k15.4k](/packages/prestashop-prestashop)[contao/core-bundle Contao Open Source CMS 1231.6M2.3k](/packages/contao-core-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)