Skip to content

Changelog

All notable changes to this project will be documented in this file.

Click here to see the unreleased changes.

2.5 - December 13, 2025

Full Changelog: v2.4...v2.5

Changed

  • Top note and footer now have more placeholder options available.

Fixed

  • The --design, --locale, and --settings options of the rendercv render command now work correctly (#543).
  • Multiline summary rendering issues in entries have been fixed.

2.4 - December 10, 2025

Full Changelog: v2.3...v2.4

Added

  • A new optional cv.headline field has been added to display a position title at the top of the CV (#442).
  • Built-in locale defaults for 11 languages have been added: French, German, Hindi, Italian, Japanese, Korean, Mandarin Chinese, Portuguese, Russian, Spanish, and Turkish. Users can now use these locales without writing all the translations themselves.
  • Nested bullet points are now supported in highlights (#177).
  • WhatsApp has been added as a social network type (#319).
  • The cv.custom_connections field has been added to allow users to define custom header connections with a placeholder (displayed text), optional URL, and Font Awesome icon name (#408).
  • Support for multiple email addresses, websites, and phone numbers has been added (#541).
  • --quiet option has been added rendercv render command to suppress all messages (#394).

Changed

  • RenderCV now uses its own Typst package, making Typst templates much clearer and simpler. The package is maintained at rendercv/rendercv-typst.
  • The documentation has been completely rewritten, including the user guide and developer guide.
  • The design field structure has been completely redesigned for better clarity and organization.
  • The rendercv_settings field has been renamed to settings.
  • The rendercv_settings.date field has been renamed to settings.current_date.

Fixed

  • Image paths are now correctly handled when providing a full image path for the photo field (#361).
  • The less than symbol < no longer causes an "unclosed label" error (#364).
  • Typst commands with parentheses (e.g., #h(1cm)) are now properly recognized and not escaped (#383).
  • C++ and other strings ending with ++ or special characters are now formatted correctly (#388, #446).
  • Rendering issues when modifying design.entry_types templates have been fixed (#413).
  • The --watch option now correctly triggers re-rendering when the YAML file changes (#513).
  • bold_keywords are now properly applied to PublicationEntry authors (#516).
  • Calling rendercv with invalid arguments now displays help text instead of raising a TypeError (#526).
  • Page margin parsing issues in v2.3 have been resolved (#531).
  • Arbitrary keys in entries are now correctly recognized and substituted in templates (#334, #376, #534).

2.3 - October 29, 2025

Full Changelog: v2.2...v2.3

Added

  • A new command-line option has been added: --nopdf to skip PDF generation (#482).
  • Two new social networks have been added: Leetcode (#483) and IMDB (#479).
  • More system fonts have been added (#466).
  • grade field has been added to EducationEntry (#463).
  • Optional automatic sorting capabilities for entries have been added (#461).

Changed

  • Docker image has been optimized for a smaller runtime size (#511).
  • Header connection order now follows the YAML key order in the input file (#455).

Fixed

  • Bold keywords now correctly ignore case and don't bold sub-words (#348).
  • Typo "parial" has been corrected to "partial" throughout the codebase (#380).
  • Arbitrary keys functionality has been fixed (#457).

2.2 - January 25, 2025

Full Changelog: v2.1...v2.2

Added

  • Two new entry types have been added: NumberedEntry and ReversedNumberedEntry.
  • Four new fields have been added to the YAML input file: design.section_titles.font_family, design.header.name_font_family, design.header.connections_font_family, and design.entries.allow_page_break_in_sections.
  • New fonts have been added: EB Garamond, Fontin, Gentium Book Plus, Lato, Noto Sans, Open Sans, Raleway, and Open Sauce Sans.
  • Users are now allowed to use custom fonts, by providing font files in the fonts folder next to the YAML input file.
  • Typst commands are now allowed in the YAML input file. For example, a text can be converted to a subscript with #sub[text].
  • A new social network has been added: X (#212, #187, #109, #107).
  • Executable files for Windows, MacOS, and Linux are now available with each release.

Fixed

  • None values in the entries are now handled correctly.
  • --png-path option of the rendercv render command has been fixed (#332).
  • Issues with escaping Markdown characters have been fixed (#347).

2.1 - January 25, 2025

Full Changelog: v2.0...v2.1

Added

  • The rendercv render error caused by an open output PDF file in Windows is now handled (#327).

Fixed

  • The "Font Awesome 6" font family issue (missing icons in the header) has been fixed (#314).
  • The Docker image has been fixed to use the latest version of RenderCV (#321).
  • Partial installation (pip install rendercv instead of pip install rendercv[full]) errors have been fixed (#326).
  • Path issues in rendercv_settings and CLI have been fixed (#312).
  • Bold and italic text rendering issues have been fixed (#303).
  • Asterisk is now escaped in Typst (#303).

2.0 - January 7, 2025

Full Changelog: v1.18...v2.0

RenderCV has transitioned from using $\LaTeX$ to Typst. RenderCV is now much faster and more powerful.

Added

  • RenderCV now supports Chinese, Japanese, and Korean characters by default (#61).
  • A new theme has been added: engineeringclassic.
  • summary field has been added to NormalEntry, ExperienceEntry, and EducationEntry (#210).
  • rendercv_settings.date field has been added for time span calculations and last updated date text.

Changed

  • $\LaTeX$ has been replaced with Typst.
  • The design field has been changed completely.
  • The locale_catalog field has been renamed to locale, and some fields have been moved from design to locale.
  • The moderncv theme's header has been changed.

1.18 - January 1, 2025

Full Changelog: v1.17...v1.18

Changed

  • design.seperator_between_connections field has been renamed to design.separator_between_connections (#282).

Fixed

  • locale field has been fixed (#282).

1.17 - December 25, 2024

Full Changelog: v1.16...v1.17

Added

  • cv.photo field has been added to the YAML input file. It allows users to add a photo to their CVs (#193).
  • rendercv_settings.bold_keywords field has been added to the YAML input file. It allows users to make specific keywords automatically bold in the rendered CV (#144).
  • markdown_to_latex filter has been added to Jinja templates (#269).

Changed

  • design.last_updated_date_style and design.page_numbering_style fields are moved to locale.last_updated_date_style and locale.page_numbering_style fields, respectively (#270).

1.16 - December 10, 2024

Full Changelog: v1.15...v1.16

Fixed

  • rendercv render command has been fixed for Python 3.10 and 3.11 (#249, #250).

1.15 - December 9, 2024

Full Changelog: v1.14...v1.15

Added

  • Four new options are added to the rendercv render command:
    • --watch (#170). It re-runs RenderCV automatically whenever the input file changes.
    • --design, --locale, and --rendercv_settings (#220). They take the design, locale, and rendercv_settings fields as separate YAML files.
  • The docker image of RenderCV is pushed to Docker Hub (#222).
  • Telegram has been added as a social network type (#187).
  • Math equations are now displayed in HTML with KaTeX (#200).

Changed

  • Math equations are now written between $$ instead of $.

Fixed

  • Path issues related to custom themes outside of root have been solved (#240).
  • URL escaping issues have been solved (#223, #236).
  • Placeholders can now be used in the rendercv_settings.render_command.output_folder_name field.
  • Special LATEX characters are now escaped in the section titles.
  • DOI rendering issues have been solved (#184).
  • The rendercv_settings.render_command.use_local_latex_command field has been fixed (#178).
  • The issue of rendering when PDF is open on Windows has been handled (#172).
  • $ sign now works without escaping (#154).
  • Timespan calculation has been fixed (#180).
  • PublicationEntry's url field's $\LaTeX$ character escaping issues have been fixed (#236).

1.14 - September 7, 2024

Full Changelog: v1.13...v1.14

Added

  • rendercv_settings field has been added to the YAML input file. It will be extended in the future.

1.13 - July 23, 2024

Full Changelog: v1.12...v1.13

Added

  • Arbitrary keys are now allowed in the cv field.
  • Two new fields have been added to the locale field: phone_number_format and date_style (#130).

Changed

  • The default value of the design.show_timespan_in field for the classic theme has been changed to [] (#135).
  • Custom theme names with digits are now allowed.

Fixed

  • The data model overriding in CLI has been fixed.
  • The url field is now shown in the PublicationEntry (#128).

1.12 - July 16, 2024

Full Changelog: v1.11...v1.12

Added

  • Arbitrary keys are now allowed in entry types. Users can use these keys in their templates.
  • The locale.full_names_of_months field has been added to the data model (#111).
  • The TODAY placeholder can be used in the design.page_numbering_style field now.

Changed

  • Some articles and prepositions (like "and," "of," "the," etc.) are now not capitalized in the section titles.

Fixed

  • The TODAY placeholder in design.last_updated_style field is localized with the new locale.full_names_of_months field (#111)
  • Rendering Markdown links with special characters has been fixed (#112).

1.11 - June 19, 2024

Full Changelog: v1.10...v1.11

Added

  • CLI options now have short versions.
  • CLI now notifies the user when a new version is available (#89).
  • Google Scholar has been added as a social network type (#85).
  • Two new design options have been added to the classic, sb2nov, and engineeringresumes themes: separator_between_connections and use_icons_for_connections.

Changed

  • The punctuation of "ORCID" has been changed to uppercase, which was previously "Orcid" (#90).
  • HTML output has been improved with better CSS (#96).
  • More complex section titles are now supported (#106).
  • Month abbreviations are not using dots anymore.
  • Date ranges are now displayed as "Month Year - Month Year" instead of "Month Year to Month Year."
  • DOI validator in the PublicationEntry has been disabled.
  • url field has been added to the PublicationEntry as an alternative to the doi field (#105)
  • YouTube username should be given without @ now.

Fixed

  • The error related to the validation_error_cause flag of Pydantic has been fixed (#66).
  • rendercv render with relative input file paths has been fixed (#95).

Removed

  • Twitter has been removed as a social network type (#109).

1.10 - May 25, 2024

Full Changelog: v1.9...v1.10

Added

  • rendercv --version command has been added to show the version of RenderCV.
  • StackOverflow (#77), GitLab (#78), ResearchGate, and YouTube has been added to the available social network types.

Fixed

  • Authors in PublicationEntry are now displayed correctly in engineeringresumes and sb2nov themes.
  • justify-with-no-hyphenation text alignment has been fixed.

1.9 - May 19, 2024

Full Changelog: v1.8...v1.9

Added

  • RenderCV is now a multilingual tool. English strings can be overridden with locale section in the YAML input file (#26, #20).
  • PNG files for each page can be generated now (#57).
  • rendercv new command now generates Markdown and $\LaTeX$ source files in addition to the YAML input file so that the default templates can be modified easily.
  • A new CLI command has been added, rendercv create-theme, to allow users to create their own themes easily. 
    rendercv create-theme "customtheme" --based-on "classic"
  • A developer guide has been written.
  • New options have been added to the rendercv render command:
    • --output-folder-name "OUTPUT_FOLDER_NAME": Generates the output files in a folder with the given name. By default, the output folder name is rendercv_output. The output folder will be created in the current working directory. (#58)
    • --latex-path LATEX_PATH: Copies the generated $\LaTeX$ source code from the output folder and pastes it to the specified path.
    • --pdf-path PDF_PATH: Copies the generated PDF file from the output folder and pastes it to the specified path.
    • --markdown-path MARKDOWN_PATH: Copies the generated Markdown file from the output folder and pastes it to the specified path.
    • --html-path HTML_PATH: Copies the generated HTML file from the output folder and pastes it to the specified path.
    • --png-path PNG_PATH: Copies the generated PNG files from the output folder and pastes them to the specified path.
    • --dont-generate-markdown: Prevents the generation of the Markdown file.
    • --dont-generate-html: Prevents the generation of the HTML file.
    • --dont-generate-png: Prevents the generation of the PNG files.
    • --ANY.LOCATION.IN.THE.YAML.FILE "VALUE": Overrides the value of ANY.LOCATION.IN.THE.YAML.FILE with VALUE. This option can be used to avoid storing sensitive information in the YAML file. Sensitive information, like phone numbers, can be passed as a command-line argument with environment variables. This method is also beneficial for creating multiple CVs using the same YAML file by changing only a few values.
  • New options have been added to the rendercv new command:
    • --dont-create-theme-source-files: Prevents the creation of the theme source files. By default, the theme source files are created.
    • --dont-create-markdown-source-files: Prevents the creation of the Markdown source files. By default, the Markdown source files are created.

Changed

  • Package size has been reduced by removing unnecessary TinyTeX files.
  • date field is now optional in PublicationEntry.
  • README.md and the documentation have been rewritten.

Fixed

  • ExperienceEntry and NormalEntry without location and dates have been fixed in the engineeringresumes, classic, and sb2nov themes.
  • $\LaTeX$ templates have been polished.
  • Bugs related to the special characters in email addresses have been fixed (#64).

1.8 - April 16, 2024

Full Changelog: v1.7...v1.8

Added

  • Horizontal space has been added between entry titles and dates in the engineeringresumes theme.
  • The date_and_location_width option has been added to the engineeringresumes theme.
  • A new design option, disable_external_link_icons, has been added.

Changed

  • sb2nov theme's $\LaTeX$ code has been changed completely. There are slight changes in the looks.
  • classic, sb2nov, and engineeringresumes use the same $\LaTeX$ code base now.
  • The design option show_last_updated_date has been renamed to disable_last_updated_date for consistency.
  • Mastodon links now use the original hostnames instead of https://mastodon.social/.

Fixed

  • The location is now shown in the header (#54).
  • The education_degree_width option of the classic theme has been fixed.
  • Lualatex and xelatex rendering problems have been fixed (#52).

1.7 - April 8, 2024

Full Changelog: v1.6...v1.7

Added

  • The new theme, engineeringresumes, is ready to be used now.
  • The education_degree_width design option has been added for the classic theme.
  • last_updated_date_template design option has been added for all the themes except moderncv.

Fixed

  • Highlights can now be broken into multiple pages in the classic theme (#47).
  • Some JSON Schema bugs have been fixed.

1.6 - March 31, 2024

Full Changelog: v1.5...v1.6

Added

  • A new theme has been added: engineeringresumes. It hasn't been tested fully yet.
  • A new text alignment option has been added to classic and sb2nov: justified-with-no-hyphenation (#34)
  • Users are now allowed to run local lualatex, xelatex, latexmk commands in addition to pdflatex (#48).

Changed

  • ORCID is now displayed in the header like other social media links.

Fixed

  • Decoding issues have been fixed (#29).
  • Classic theme's ExperienceEntry has been fixed (#49).

1.5 - March 27, 2024

Full Changelog: v1.4...v1.5

Added

  • Users can now make bold or italic texts normal with Markdown syntax.

Changed

  • The moderncv theme doesn't italicize any text by default now.

Fixed

  • The moderncv theme's PDF title issue has been fixed.
  • The ordering of the data models' keys in JSON Schema has been fixed.
  • The unhandled exception when a custom theme's __init__.py file is invalid has been fixed.
  • The sb2nov theme's PublicationEntry without journal and doi fields is now rendered correctly.
  • The sb2nov theme's OneLineEntry's colon issue has been fixed.

1.4 - March 10, 2024

Full Changelog: v1.3...v1.4

Added

  • A new entry type has been added: BulletEntry

Changed

  • OneLineEntry's name field has been changed to label. This was required to generalize the entry validations.
  • moderncv's highlights are now bullet points.
  • moderncv's TextEntries don't have bullet points anymore.
  • sb2nov's TextEntries don't have bullet points anymore.

1.3 - March 9, 2024

Full Changelog: v1.2...v1.3

Added

  • CLI documentation has been added to the user guide.

Changed

  • Future dates are now allowed.
  • Authors' first names are no longer abbreviated in PublicationEntry.
  • Markdown is now supported in the authors field of PublicationEntry.
  • doi field is now optional for PublicationEntry.

Fixed

  • The journal is now displayed in the PublicationEntry of the sb2nov theme.

1.2 - February 27, 2024

Full Changelog: v1.1...v1.2

Fixed

  • Markdown TextEntry, where all the paragraphs were concatenated into a single paragraph, has been fixed.
  • Markdown OneLineEntry, where all the one-line entries were concatenated into a single line, has been fixed.
  • The classic theme's PublicationEntry, where blank parentheses were rendered when the journal field was not provided, has been fixed.
  • A bug where an email with special characters caused a $\LaTeX$ error has been fixed.
  • The Unicode error when rendercv new is called with a name containing special characters has been fixed.

1.1 - February 25, 2024

Full Changelog: v0.10...v1.1

Added

  • RenderCV is now a $\LaTeX$ CV framework. Users can move their $\LaTeX$ CV themes to RenderCV to produce their CV from RenderCV's YAML input.
  • RenderCV now generates Markdown and HTML versions of the CV to allow users to paste the content of the CV to another software (like Grammarly) for spell checking.
  • A new theme has been added: moderncv.
  • A new theme has been added: sb2nov.

Changed

  • The data model has been changed to be more flexible. All the sections are now under the sections field. All the keys are arbitrary and rendered as section titles. The entry types can be any of the six built-in entry types, and they will be detected by RenderCV for each section.
  • The templating system has been changed completely.
  • The command-line interface (CLI) has been improved.
  • The validation error messages have been improved.
  • TinyTeX has been moved to another repository, and it is being pulled as a Git submodule. It is still pushed to PyPI, but it's not a part of the repository anymore.
  • Tests have been improved, and it uses pytest instead of unittest.
  • The documentation has been rewritten.
  • The reference has been rewritten.
  • The build system has been changed from setuptools to hatchling.

0.10 - November 29, 2023

Full Changelog: v0.9...v0.10

Fixed

  • Author highlighting issue has been fixed in PublicationEntry.

0.9 - November 29, 2023

Full Changelog: v0.8...v0.9

Added

  • Page numbering has been added.
  • Text alignment options have been added (left-aligned or justified).
  • Header options (margins and header font size) have been added.
  • The university_projects field has been added.

0.8 - November 17, 2023

Full Changelog: v0.7...v0.8

Fixed

  • YYYY date issue has been solved (#5).

0.7 - November 3, 2023

Full Changelog: v0.6...v0.7

Changed

  • The date type has been improved. It now supports YYYY-MM-DD, YYYY-MM, and YYYY formats.

Fixed

  • The error messages for custom sections have been fixed.

0.6 - October 28, 2023

Full Changelog: v0.5...v0.6

Added

  • New fields have been added: experience, projects, awards, interests, and programming_skills.

Fixed

  • DOI validation bug has been fixed by @LabAsim in #3.

0.5 - October 27, 2023

Full Changelog: v0.4...v0.5

Added

  • ORCID support has been added.

Fixed

  • Special $\LaTeX$ characters' escaping has been fixed.

0.4 - October 22, 2023

Full Changelog: v0.3...v0.4

Changed

  • CLI has been improved for more intuitive validation error messages.

0.3 - October 20, 2023

Full Changelog: v0.2...v0.3

Fixed

  • The colors of the CLI output have been fixed.
  • Encoding problems have been fixed.

0.2 - October 17, 2023

Full Changelog: v0.1...v0.2

Fixed

  • MacOS compatibility issues have been fixed.

0.1 - October 15, 2023

The first release of RenderCV.