HTML preprocessors can make writing HTML more powerful or convenient. For instance, Markdown is designed to be easier to write and read for text documents and you could write a loop in Pug.
In CodePen, whatever you write in the HTML editor is what goes within the <body>
tags in a basic HTML5 template. So you don't have access to higher-up elements like the <html>
tag. If you want to add classes there that can affect the whole document, this is the place to do it.
In CodePen, whatever you write in the HTML editor is what goes within the <body>
tags in a basic HTML5 template. If you need things in the <head>
of the document, put that code here.
The resource you are linking to is using the 'http' protocol, which may not work when the browser is using https.
CSS preprocessors help make authoring CSS easier. All of them offer things like variables and mixins to provide convenient abstractions.
It's a common practice to apply CSS to a page that styles elements such that they are consistent across all browsers. We offer two of the most popular choices: normalize.css and a reset. Or, choose Neither and nothing will be applied.
To get the best cross-browser support, it is a common practice to apply vendor prefixes to CSS properties and values that require them to work. For instance -webkit-
or -moz-
.
We offer two popular choices: Autoprefixer (which processes your CSS server-side) and -prefix-free (which applies prefixes via a script, client-side).
Any URLs added here will be added as <link>
s in order, and before the CSS in the editor. You can use the CSS from another Pen by using its URL and the proper URL extension.
You can apply CSS to your Pen from any stylesheet on the web. Just put a URL to it here and we'll apply it, in the order you have them, before the CSS in the Pen itself.
You can also link to another Pen here (use the .css
URL Extension) and we'll pull the CSS from that Pen and include it. If it's using a matching preprocessor, use the appropriate URL Extension and we'll combine the code before preprocessing, so you can use the linked Pen as a true dependency.
JavaScript preprocessors can help make authoring JavaScript easier and more convenient.
Babel includes JSX processing.
Any URL's added here will be added as <script>
s in order, and run before the JavaScript in the editor. You can use the URL of any other Pen and it will include the JavaScript from that Pen.
You can apply a script from anywhere on the web to your Pen. Just put a URL to it here and we'll add it, in the order you have them, before the JavaScript in the Pen itself.
If the script you link to has the file extension of a preprocessor, we'll attempt to process it before applying.
You can also link to another Pen here, and we'll pull the JavaScript from that Pen and include it. If it's using a matching preprocessor, we'll combine the code before preprocessing, so you can use the linked Pen as a true dependency.
Search for and use JavaScript packages from npm here. By selecting a package, an import
statement will be added to the top of the JavaScript editor for this package.
Using packages here is powered by esm.sh, which makes packages from npm not only available on a CDN, but prepares them for native JavaScript ESM usage.
All packages are different, so refer to their docs for how they work.
If you're using React / ReactDOM, make sure to turn on Babel for the JSX processing.
If active, Pens will autosave every 30 seconds after being saved once.
If enabled, the preview panel updates automatically as you code. If disabled, use the "Run" button to update.
If enabled, your code will be formatted when you actively save your Pen. Note: your code becomes un-folded during formatting.
Visit your global Editor Settings.
<header aria-label="Masthead">
<h1>
<small>Mike Mai’s</small>
<span>Typography<br>Manual</span>
</h1>
</header>
<main>
<article>
<h2>Use One Font</h2>
<p>Believe it or not, you can do a lot with just a single font. Choose a well designed font and explore all of its weights, this works best with <a href="https://fonts.google.com/?vfonly=true">variable fonts</a>. If a font you like does not have multiple weights, you could utilize colors to <a href="https://mikemai.net/typesettings/showcase-im-fell-english.html">create contrast</a> between headings and body text.</p>
<p>This manual is set in Archivo 300, 600, and 900.</p>
<h2>Use Traditional Point Sizes</h2>
<p>You can’t learn typography overnight. As a beginner, it could feel daunting to set up a type scale. If you are at a loss, it would be safe to utilize the set of traditional point sizes.</p>
<p>Remember to convert the point value to <q>rem</q> when designing for the web.</p>
<figure>
<p class="pt-double-canon">Double Canon</p>
<p class="pt-canon">Canon</p>
<p class="pt-double-great-primer">Double Great Primer</p>
<p class="pt-double-english">Double English</p>
<p class="pt-double-pica">Double Pica</p>
<p class="pt-paragon">Paragon</p>
<p class="pt-english">English</p>
<p class="pt-pica">Pica</p>
<p class="pt-small-pica">Small Pica</p>
<p class="pt-bourgeois">Bourgeois</p>
</figure>
<table>
<caption>
Type Scale with Traditional Point Sizes
</caption>
<thead>
<tr>
<th>Text Style</th>
<th>Point Size</th>
<th>Rem Size</th>
</tr>
</thead>
<tbody>
<tr>
<td>Display</td>
<td>Double Canon</td>
<td>4.666</td>
</tr>
<tr>
<td>Heading 1</td>
<td>Canon</td>
<td>3.999</td>
</tr>
<tr>
<td>Heading 2</td>
<td>Double Great Primer</td>
<td>2.999</td>
</tr>
<tr>
<td>Heading 3</td>
<td>Double English</td>
<td>2.333</td>
</tr>
<tr>
<td>Heading 4</td>
<td>Double Pica</td>
<td>2.000</td>
</tr>
<tr>
<td>Heading 5</td>
<td>Paragon</td>
<td>1.666</td>
</tr>
<tr>
<td>Heading 6</td>
<td>English</td>
<td>1.166</td>
</tr>
<tr>
<td>Body</td>
<td>Pica</td>
<td>1.000</td>
</tr>
<tr>
<td>Fine Print 1</td>
<td>Small Pica</td>
<td>0.916</td>
</tr>
<tr>
<td>Fine Print 2</td>
<td>Bourgeois</td>
<td>0.750</td>
</tr>
</tbody>
</table>
<h2>Redefine Point Sizes for CJK Characters</h2>
<p>CJK (Chinese, Japanese, Korean) characters are wildly different than Latin characters. Make sure to pick point sizes that would look good with CJK characters.</p>
<figure>
<div lang="zh-Hans">
<p class="pt-chu">初号</p>
<p class="pt-xiaochu">小初号</p>
<p class="pt-yi">一号</p>
<p class="pt-er">二号</p>
<p class="pt-xiaoer">小二号</p>
<p class="pt-san">三号</p>
<p class="pt-si">四号</p>
<p class="pt-xiaosi">小四号</p>
<p class="pt-wu">五号</p>
<p class="pt-xiaowu">小五号</p>
</div>
</figure>
<table>
<caption>
Type Scale with CJK Point Sizes
</caption>
<thead>
<tr>
<th>Text Style</th>
<th>Point Size</th>
<th>Rem Size</th>
</tr>
</thead>
<tbody>
<tr>
<td>Display</td>
<td lang="zh-Hans">初号</td>
<td>3.499</td>
</tr>
<tr>
<td>Heading 1</td>
<td lang="zh-Hans">小初号</td>
<td>2.999</td>
</tr>
<tr>
<td>Heading 2</td>
<td lang="zh-Hans">一号</td>
<td>2.166</td>
</tr>
<tr>
<td>Heading 3</td>
<td lang="zh-Hans">二号</td>
<td>1.833</td>
</tr>
<tr>
<td>Heading 4</td>
<td lang="zh-Hans">小二号</td>
<td>1.500</td>
</tr>
<tr>
<td>Heading 5</td>
<td lang="zh-Hans">三号</td>
<td>1.333</td>
</tr>
<tr>
<td>Heading 6</td>
<td lang="zh-Hans">四号</td>
<td>1.166</td>
</tr>
<tr>
<td>Body</td>
<td lang="zh-Hans">小四号</td>
<td>1.000</td>
</tr>
<tr>
<td>Fine Print 1</td>
<td lang="zh-Hans">五号</td>
<td>0.875</td>
</tr>
<tr>
<td>Fine Print 2</td>
<td lang="zh-Hans">小五号</td>
<td>0.750</td>
</tr>
</tbody>
</table>
<h2>Use Serif for Italic Text</h2>
<p>Chances are that italic sans-serif is ugly. Why? Because the style is not available for certain sans-serif fonts and you end up with forced italics. Even if it is available, it is usually poorly designed. Inspect carefully when using italic sans-serif, or substitute a serif font for italic text—<em>it’s worth it, trust me</em>.</p>
<h2>Use En Dash & Em Dash</h2>
<p>Did you know dashes have different widths?</p>
<p>The em dash—the long dash—is for indicating a break in the sentence. The en dash is slightly wider than the hyphen and narrower than the em dash, and it should be used for span or range of numbers. Hyphen is for hyphen­ation, duh!</p>
<h2><q>Hang Quotes & Bullets</q></h2>
<ul role="presentation">
<li role="presentation">Because</li>
<li role="presentation">text</li>
<li role="presentation">should</li>
<li role="presentation">align</li>
</ul>
<p>to ensure the flow of reading.</p>
<p>When letters align with letters, text blocks are uniform. Avoid distracting the eye with indents.</p>
<h2>Use One Space after a Period</h2>
<p>Unless you are still using a typewriter or you still think your professor was right. Hint, you are not and they were not. Digital typefaces are designed with proper kerning. Let obsolete practices stay in the past.</p>
<h2>Reduce Heading Spacing</h2>
<p>Humans always look for patterns. When elements are close to each other, we consciously group them as related information.</p>
<p>The spacing between a heading and a paragraph should be less than the regular paragraph spacing. If regular paragraph spacing is used instead, the heading would seem too far away from the paragraph.</p>
<h2>Use Thin Space</h2>
<p>Thin Space might be the most underrated HTML entity. It can be used for a name like J. K. Simmons. Without spacing, the J and K would seem too close together; with a regular space, they seem too far apart. Insert a thin space and it is just perfect.</p>
<p>The HTML code is <mark>&thinsp;</mark>. You can go even further with Hair Space <mark>&#8202;</mark>.</p>
<p><a href="https://codepen.io/mikemai2awesome/pen/LYQwBmp">A demo on Thin Space</a> →</p>
<h2>Use Paragraph Indent or Paragraph Spacing, Never Both</h2>
<p>Do you wear suspenders while you are already wearing a belt? I didn’t think so.</p>
<h2>Don’t Use Helvetica, Inter, & Roboto</h2>
<p>You might enjoy eating <a href="https://helveticasux.com">McDonald’s</a> but you know that is not healthy for you. Pick a font that is not so ubiquitous, YOLO!</p>
</article>
</main>
<footer aria-label="Colophon">
<p>Crafted in HTML & CSS by <a href="https://mikemai.net">Mike Mai</a>. The guidelines in this manual are solely based on his typographic philosophy and visual judgment.</p>
<p>Originally released on <a href="https://codepen.io/mikemai2awesome/pen/qBygNwq">Codepen</a>.</p>
</footer>
:root {
--gutter: clamp(1ch, 2.5vmax, 3ch);
--stack: clamp(1.25ex, 2.5vmax, 1.75ex);
--line-length: 70ch;
--page-padding-inline: calc(
(100vw - min(90rem, 100vw - var(--gutter) * 3)) / 2
);
--section-spacing: clamp(var(--stack) * 4, 10vmax, var(--stack) * 6);
--pt-double-canon: 4.666rem;
--pt-canon: 3.999rem;
--pt-double-great-primer: 2.999rem;
--pt-double-english: 2.333rem;
--pt-double-pica: 2rem;
--pt-paragon: 1.666rem;
--pt-great-primer: 1.5rem;
--pt-english: 1.166rem;
--pt-pica: 1rem;
--pt-small-pica: 0.916rem;
--pt-long-primer: 0.833rem;
--pt-bourgeois: 0.75rem;
--pt-chu: 3.499rem;
--pt-xiaochu: 2.999rem;
--pt-yi: 2.166rem;
--pt-xiaoyi: 1.999rem;
--pt-er: 1.833rem;
--pt-xiaoer: 1.5rem;
--pt-san: 1.333rem;
--pt-xiaosan: 1.25rem;
--pt-si: 1.166rem;
--pt-xiaosi: 1rem;
--pt-wu: 0.875rem;
--pt-xiaowu: 0.75rem;
font-family: "Archivo", system-ui, sans-serif;
font-size: clamp(100%, 90% + 0.5vw, 150%);
font-weight: 300;
line-height: 1.4;
color-scheme: dark light;
}
*,
*::before,
*::after {
font-feature-settings: "kern";
font-kerning: normal;
-moz-osx-font-smoothing: grayscale !important;
-webkit-font-smoothing: antialiased !important;
box-sizing: border-box;
}
* {
margin: 0;
padding: 0;
}
body {
display: grid;
gap: var(--section-spacing);
padding-inline: var(--page-padding-inline);
overflow-x: hidden;
}
header {
display: grid;
align-content: end;
min-block-size: 100vh;
min-block-size: 100dvb;
padding-block: var(--section-spacing);
}
footer {
margin-block: var(--section-spacing);
padding-inline-start: var(--gutter);
border-inline-start: 6px double;
}
a {
font-weight: 600;
color: currentcolor;
text-underline-offset: 0.2ex;
}
em {
font-family: "Georgia", serif;
}
h1,
h2 {
font-weight: 900;
}
h1 {
display: grid;
gap: 0.2ex;
align-content: center;
font-size: clamp(
var(--pt-paragon),
var(--pt-pica) + 4.125vw,
var(--pt-double-canon)
);
line-height: 1;
letter-spacing: -0.02em;
text-transform: uppercase;
}
h1 small {
font-size: var(--pt-bourgeois);
font-weight: 300;
letter-spacing: 0.1em;
text-indent: 0.1ch;
}
h1 span {
text-indent: -0.225ch;
}
article {
counter-reset: section;
}
h2 {
display: grid;
gap: 0.25ex;
position: relative;
max-inline-size: 25ch;
margin-block-start: var(--section-spacing);
font-size: clamp(
var(--pt-great-primer),
var(--pt-small-pica) + 4.125vw,
var(--pt-double-great-primer)
);
line-height: 1.2;
}
h2::before,
h2::after {
font-size: var(--pt-long-primer);
line-height: 1;
}
h2::before {
content: "\02116"counter(section);
counter-increment: section;
justify-self: start;
padding: 0.5ex;
font-weight: 600;
border: 6px double;
border-radius: 1px;
}
h2::after {
content: "";
position: absolute;
transform: translate3d(-100%, calc(3px + 0.5ex + 0.5em), 0);
inline-size: var(--page-padding-inline);
border-block-end: 2px solid;
}
h2 q {
position: relative;
}
h2 q::before {
position: absolute;
transform: translatex(-100%);
}
h2 + p {
margin-block-start: calc(var(--stack) * 0.5);
}
p,
ul {
max-inline-size: var(--line-length);
margin-block-start: var(--stack);
}
p:first-child {
margin-block-start: 0;
}
figure,
table {
margin-block-start: calc(var(--section-spacing) * 0.5);
}
figure {
position: relative;
inset-inline-start: 50%;
inset-inline-end: 50%;
inline-size: 100%;
inline-size: 100vw;
margin-inline-start: -50vw;
margin-inline-end: -50vw;
padding-inline: var(--page-padding-inline);
padding-block-end: 1ex;
overflow: auto;
scrollbar-gutter: stable;
}
table {
inline-size: 100%;
max-inline-size: var(--line-length);
}
table,
th,
td {
border: 1px solid;
}
th,
td {
padding: 0.5ex;
text-align: start;
}
th {
padding-block: 1ex;
font-weight: 600;
font-size: var(--pt-bourgeois);
letter-spacing: 0.04em;
text-transform: uppercase;
}
caption {
margin-block-end: calc(var(--stack) * 0.5);
font-size: var(--pt-english);
font-weight: 900;
text-align: start;
}
[class^="pt-"] {
display: flex;
gap: 1rem;
align-items: center;
block-size: 1.5em;
font-weight: 300;
line-height: 1;
letter-spacing: -0.02em;
white-space: nowrap;
&::before {
display: grid;
place-items: center;
min-block-size: 50%;
padding-inline-end: 0.5rem;
font-size: var(--pt-bourgeois);
font-weight: 600;
letter-spacing: 0;
text-align: center;
text-transform: uppercase;
word-break: break-all;
border-inline-end: 6px double;
}
}
[class^="pt-"] + [class^="pt-"] {
margin-block-start: 2vmax;
}
.pt-double-canon {
font-size: var(--pt-double-canon);
&::before {
content: "56";
}
}
.pt-canon {
font-size: var(--pt-canon);
&::before {
content: "48";
}
}
.pt-double-great-primer {
font-size: var(--pt-double-great-primer);
&::before {
content: "36";
}
}
.pt-double-english {
font-size: var(--pt-double-english);
&::before {
content: "28";
}
}
.pt-double-pica {
font-size: var(--pt-double-pica);
&::before {
content: "24";
}
}
.pt-paragon {
font-size: var(--pt-paragon);
&::before {
content: "20";
}
}
.pt-great-primer {
font-size: var(--pt-great-primer);
&::before {
content: "18";
}
}
.pt-english {
font-size: var(--pt-english);
&::before {
content: "14";
}
}
.pt-pica {
font-size: var(--pt-pica);
&::before {
content: "12";
}
}
.pt-small-pica {
font-size: var(--pt-small-pica);
&::before {
content: "11";
}
}
.pt-long-primer {
font-size: var(--pt-long-primer);
&::before {
content: "10";
}
}
.pt-bourgeois {
font-size: var(--pt-bourgeois);
&::before {
content: "09";
}
}
.pt-chu {
font-size: var(--pt-chu);
&::before {
content: "42";
}
}
.pt-xiaochu {
font-size: var(--pt-xiaochu);
&::before {
content: "36";
}
}
.pt-yi {
font-size: var(--pt-yi);
&::before {
content: "26";
}
}
.pt-xiaoyi {
font-size: var(--pt-xiaoyi);
&::before {
content: "24";
}
}
.pt-er {
font-size: var(--pt-er);
&::before {
content: "22";
}
}
.pt-xiaoer {
font-size: var(--pt-xiaoer);
&::before {
content: "18";
}
}
.pt-san {
font-size: var(--pt-san);
&::before {
content: "16";
}
}
.pt-xiaosan {
font-size: var(--pt-xiaosan);
&::before {
content: "15";
}
}
.pt-si {
font-size: var(--pt-si);
&::before {
content: "14";
}
}
.pt-xiaosi {
font-size: var(--pt-xiaosi);
&::before {
content: "12";
}
}
.pt-wu {
font-size: var(--pt-wu);
&::before {
content: "10.5";
}
}
.pt-xiaowu {
font-size: var(--pt-xiaowu);
&::before {
content: "9";
}
}
[lang="zh-Hans"] {
font-family: system-ui, sans-serif;
}
table [lang="zh-Hans"] {
font-weight: 600;
}
figure div[lang="zh-Hans"] {
writing-mode: vertical-lr;
[class^="pt-"] {
font-weight: 900;
letter-spacing: 0.25em;
&::before {
min-block-size: 100%;
font-size: var(--pt-xiaowu);
}
}
}
Also see: Tab Triggers