Upgrading to 4.x¶
Material for MkDocs 4 fixes incorrect layout on Chinese systems. The fix includes a mandatory change of the base font-size from
20px which means all
rem values needed to be updated. Within the theme,
rem calculation is now encapsulated in a new function called
px2rem which is part of the SASS code base.
If you use Material for MkDocs with custom CSS that is based on
rem values, note that those values must now be divided by 2. Now,
1.0rem doesn't map to
20px. To learn more about the problem and implications, please refer to the issue in which the problem was discovered and fixed.
How to upgrade¶