DEADB17 / org-mode-css

Lightweight css to use when exporting org documents as html

org-mode css

CSS file to make org mode documents look better when exported as html.

• Light-weight single CSS file. No JavaScript, no images, no custom fonts
• Responsive across screens sizes
• Dark mode for screens, light mode for print
• Normalized across browsers and operating systems
• Minimalist design, just enough to enhance readability
• Simple to change and extend (edit this file and export)

View the sample document.

Some alternatives:

• fniessen/org-html-themes
• gongzhitaao/orgcss
• thomasf/solarized-css
• caffo/org-minimal-html-theme

Usage

1. Download docs/org.css.
2. Reference it in the settings section of the file that will be exported.

   #+HTML_HEAD: <link rel="stylesheet" href="org.css">
       

   E.g.:

   #+OPTIONS: ':nil *:t -:t ::t <:t H:3 \n:nil ^:nil arch:headline author:t
   #+OPTIONS: broken-links:nil c:nil creator:t d:(not "LOGBOOK") date:t e:t
   #+OPTIONS: email:t f:t inline:t num:nil p:nil pri:nil prop:nil stat:t tags:t
   #+OPTIONS: tasks:t tex:t timestamp:t title:t toc:nil todo:t |:t
   #+OPTIONS: html-style:nil html-scripts:nil
   #+OPTIONS: html5-fancy:t
   #+HTML_CONTAINER: section
   #+HTML_DOCTYPE: html5
   #+HTML_HEAD: <link rel="stylesheet" href="org.css">
   #+LANGUAGE: en
   #+SELECT_TAGS: export
   #+EXCLUDE_TAGS: noexport
   #+CREATOR: Emacs 26.1 (Org mode 9.1.14)
       

Generate the org.css output file

The output file is generated from this document. To generate it evaluate ( C-c C-c ) this source block.

cat $sanitize $typography $forms $org $colors

If you have Node.js and npm installed evaluate this source block to minify the file.

npx uglifycss $sanitize $typography $forms $org $colors

org.css contents

The customized options are in the Org and Colors sections below. The other sections are from the sanitize.css project.

Org

h2, h3, h4, h5, h6 {
  display: flex;
  align-items: baseline;
  flex-wrap: wrap;
}

h1, h2, h3, h4 {
  line-height: 1;
  font-weight: normal;
}

h1 {font-size: 3.052em;}

h2 {font-size: 2.441em;}

h3 {font-size: 1.953em;}

h4 {font-size: 1.563em;}

h5 {font-size: 1.25em;}

p {hyphens: auto;}

small {font-size: 0.8em;}

kbd {
  display: inline-block;
  padding: 0.19em 0.31em;
  font-size: 75%;
  vertical-align: middle;
  border-width: 1px;
  border-style: solid;
  border-radius: 20%;
}

body > * {
  max-width: 60rem;
  margin-left: 1rem;
  margin-right: 1rem;
}

ul,
ol {padding-left: 1.5em;}

thead > tr,
tbody > tr {border-bottom: 0.0625em solid;}
tbody {border-bottom: 0.188em solid;}
tbody:last-child,
tbody > tr:last-child {border-bottom: none;}

th,
td {padding: 0.4em 1.2em;}
th:first-child,
td:first-child {padding-left: 0;}
th:last-child,
td:last-child {padding-right: 0;}

blockquote {
  margin-right: 0;
  border-right: .125em solid;
  padding-right: 1em;
  margin-left: 0;
  border-left: .125em solid;
  padding-left: 1em;
}

table,
figure {
  margin-left: auto;
  margin-right: auto;
}

figure {
  text-align: center;
}

img,
object {
  max-width: 100%;
}

.title { text-align: center; }

.ABSTRACT {
  border-top: 0.125em solid;
  border-bottom: 0.125em solid;
}

.underline { text-decoration: underline; }

pre.src,
pre.example {
  overflow-x: auto;
  padding: 0 1em;
  background: repeating-linear-gradient(rgba(0,0,0,.0625), rgba(0,0,0,.0625) 1.5em, transparent 1.5em, transparent 3em);
}

.on > code,
.trans > code,
.off > code { display: none; }
.on::marker,
.trans::marker,
.off::marker { padding-right: 0.5em; }
.on::marker { content: "☑"}
.trans::marker,
.off::marker { content: "□"}

h2 .timestamp-wrapper,
h3 .timestamp-wrapper,
h4 .timestamp-wrapper,
h5 .timestamp-wrapper,
#table-of-contents .timestamp-wrapper
{ font-size: 80%; }

.timestamp-wrapper,
.priority,
.todo,
.done {
  font-weight: normal;
}
.todo,
.done {
  border: 0.125em solid;
  font-size: 60%;
  padding: .2em;
}

h2 .priority,
h2 .todo,
h2 .done,
h3 .priority,
h3 .todo,
h3 .done,
h4 .priority,
h4 .todo,
h4 .done,
h5 .priority,
h5 .todo,
h5 .done,
h6 .priority,
h6 .todo,
h6 .done
{ margin-right: 0.5em; }

.timestamp-wrapper,
.priority,
.todo,
.done,
.tag {opacity: 0.66;}

.tag {
  font-weight: normal;
  margin-left: auto;
}

.footref {
  padding: 0 0.25em;
  text-decoration: none;
}
.footdef { display: flex; }
.footdef sup { padding-right: 0.5rem; }
.footpara { margin-top: 0; }

#table-of-contents ul {
  padding-left: 1em;
}

#postamble {
  display: flex;
  flex-wrap: wrap;
  justify-content: space-between;
  font-size: 0.8em;
  margin-top: 6rem;
  margin-bottom: 1rem;
  border-top: 0.125em solid;
}
#postamble > * { margin-bottom: 0; }
#postamble > .validation { display: none; }

@media (min-width: 62rem) {
  body > * {
    margin-left: auto;
    margin-right: auto;
  }
}

@media (min-width: 84rem) {
  body {
    max-width: 84rem;
    margin-left: auto;
    margin-right: auto;
  }

  body > * {
    margin-left: 1rem;
    margin-right: 1rem;
  }

  #table-of-contents {
    position: fixed;
    top: 0;
    right: 1rem;
    bottom: 0;
    width: calc((100% - 44rem) / 2);
    overflow-y: auto;
  }

  #table-of-contents > h2 {
    font-size: 1.563em;
  }
}

Colors

@media screen {
  body {
    color: #eeeeec;
    background-color: #2e3436;
  }

  kbd {
    color: #eeeeec;
    background-color: #50595b;
    border-color: ##848e89;
  }

  a:link {color: #8cc4ff;}

  a:visited {color: #e090d7;}

  .priority {color: #fce94f;}
  .todo {color: #fcaf3e;}
  .done { color: #8ae234;}
}

Sanitize

/* Document
 * ========================================================================== */

/**
 * Add border box sizing in all browsers (opinionated).
 */

*,
::before,
::after {
  box-sizing: border-box;
}

/**
 * 1. Add text decoration inheritance in all browsers (opinionated).
 * 2. Add vertical alignment inheritance in all browsers (opinionated).
 */

::before,
::after {
  text-decoration: inherit; /* 1 */
  vertical-align: inherit; /* 2 */
}

/**
 * 1. Use the default cursor in all browsers (opinionated).
 * 2. Change the line height in all browsers (opinionated).
 * 3. Use a 4-space tab width in all browsers (opinionated).
 * 4. Remove the grey highlight on links in iOS (opinionated).
 * 5. Prevent adjustments of font size after orientation changes in
 *    IE on Windows Phone and in iOS.
 * 6. Breaks words to prevent overflow in all browsers (opinionated).
 */

html {
  cursor: default; /* 1 */
  line-height: 1.5; /* 2 */
  -moz-tab-size: 4; /* 3 */
  tab-size: 4; /* 3 */
  -webkit-tap-highlight-color: transparent /* 4 */;
  -ms-text-size-adjust: 100%; /* 5 */
  -webkit-text-size-adjust: 100%; /* 5 */
  word-break: break-word; /* 6 */
}

/* Sections
 * ========================================================================== */

/**
 * Remove the margin in all browsers (opinionated).
 */

body {
  margin: 0;
}

/**
 * Correct the font size and margin on `h1` elements within `section` and
 * `article` contexts in Chrome, Edge, Firefox, and Safari.
 */

h1 {
  font-size: 2em;
  margin: 0.67em 0;
}

/* Grouping content
 * ========================================================================== */

/**
 * Remove the margin on nested lists in Chrome, Edge, IE, and Safari.
 */

dl dl,
dl ol,
dl ul,
ol dl,
ul dl {
  margin: 0;
}

/**
 * Remove the margin on nested lists in Edge 18- and IE.
 */

ol ol,
ol ul,
ul ol,
ul ul {
  margin: 0;
}

/**
 * 1. Add the correct sizing in Firefox.
 * 2. Show the overflow in Edge 18- and IE.
 */

hr {
  height: 0; /* 1 */
  overflow: visible; /* 2 */
}

/**
 * Add the correct display in IE.
 */

main {
  display: block;
}

/**
 * Remove the list style on navigation lists in all browsers (opinionated).
 */

/*
nav ol,
nav ul {
  list-style: none;
  padding: 0;
}
*/

/**
 * 1. Correct the inheritance and scaling of font size in all browsers.
 * 2. Correct the odd `em` font sizing in all browsers.
 */

pre {
  font-family: monospace, monospace; /* 1 */
  font-size: 1em; /* 2 */
}

/* Text-level semantics
 * ========================================================================== */

/**
 * Remove the gray background on active links in IE 10.
 */

a {
  background-color: transparent;
}

/**
 * Add the correct text decoration in Edge 18-, IE, and Safari.
 */

abbr[title] {
  text-decoration: underline;
  text-decoration: underline dotted;
}

/**
 * Add the correct font weight in Chrome, Edge, and Safari.
 */

b,
strong {
  font-weight: bolder;
}

/**
 * 1. Correct the inheritance and scaling of font size in all browsers.
 * 2. Correct the odd `em` font sizing in all browsers.
 */

code,
kbd,
samp {
  font-family: monospace, monospace; /* 1 */
  font-size: 1em; /* 2 */
}

/**
 * Add the correct font size in all browsers.
 */

small {
  font-size: 80%;
}

/* Embedded content
 * ========================================================================== */

/*
 * Change the alignment on media elements in all browsers (opinionated).
 */

audio,
canvas,
iframe,
img,
svg,
video {
  vertical-align: middle;
}

/**
 * Add the correct display in IE 9-.
 */

audio,
video {
  display: inline-block;
}

/**
 * Add the correct display in iOS 4-7.
 */

audio:not([controls]) {
  display: none;
  height: 0;
}

/**
 * Remove the border on iframes in all browsers (opinionated).
 */

iframe {
  border-style: none;
}

/**
 * Remove the border on images within links in IE 10-.
 */

img {
  border-style: none;
}

/**
 * Change the fill color to match the text color in all browsers (opinionated).
 */

svg:not([fill]) {
  fill: currentColor;
}

/**
 * Hide the overflow in IE.
 */

svg:not(:root) {
  overflow: hidden;
}

/* Tabular data
 * ========================================================================== */

/**
 * Collapse border spacing in all browsers (opinionated).
 */

table {
  border-collapse: collapse;
}

/* Forms
 * ========================================================================== */

/**
 * Remove the margin on controls in Safari.
 */

button,
input,
select {
  margin: 0;
}

/**
 * 1. Show the overflow in IE.
 * 2. Remove the inheritance of text transform in Edge 18-, Firefox, and IE.
 */

button {
  overflow: visible; /* 1 */
  text-transform: none; /* 2 */
}

/**
 * Correct the inability to style buttons in iOS and Safari.
 */

button,
[type="button"],
[type="reset"],
[type="submit"] {
  -webkit-appearance: button;
}

/**
 * 1. Change the inconsistent appearance in all browsers (opinionated).
 * 2. Correct the padding in Firefox.
 */

fieldset {
  border: 1px solid #a0a0a0; /* 1 */
  padding: 0.35em 0.75em 0.625em; /* 2 */
}

/**
 * Show the overflow in Edge 18- and IE.
 */

input {
  overflow: visible;
}

/**
 * 1. Correct the text wrapping in Edge 18- and IE.
 * 2. Correct the color inheritance from `fieldset` elements in IE.
 */

legend {
  color: inherit; /* 2 */
  display: table; /* 1 */
  max-width: 100%; /* 1 */
  white-space: normal; /* 1 */
}

/**
 * 1. Add the correct display in Edge 18- and IE.
 * 2. Add the correct vertical alignment in Chrome, Edge, and Firefox.
 */

progress {
  display: inline-block; /* 1 */
  vertical-align: baseline; /* 2 */
}

/**
 * Remove the inheritance of text transform in Firefox.
 */

select {
  text-transform: none;
}

/**
 * 1. Remove the margin in Firefox and Safari.
 * 2. Remove the default vertical scrollbar in IE.
 * 3. Change the resize direction in all browsers (opinionated).
 */

textarea {
  margin: 0; /* 1 */
  overflow: auto; /* 2 */
  resize: vertical; /* 3 */
}

/**
 * Remove the padding in IE 10-.
 */

[type="checkbox"],
[type="radio"] {
  padding: 0;
}

/**
 * 1. Correct the odd appearance in Chrome, Edge, and Safari.
 * 2. Correct the outline style in Safari.
 */

[type="search"] {
  -webkit-appearance: textfield; /* 1 */
  outline-offset: -2px; /* 2 */
}

/**
 * Correct the cursor style of increment and decrement buttons in Safari.
 */

::-webkit-inner-spin-button,
::-webkit-outer-spin-button {
  height: auto;
}

/**
 * Correct the text style of placeholders in Chrome, Edge, and Safari.
 */

::-webkit-input-placeholder {
  color: inherit;
  opacity: 0.54;
}

/**
 * Remove the inner padding in Chrome, Edge, and Safari on macOS.
 */

::-webkit-search-decoration {
  -webkit-appearance: none;
}

/**
 * 1. Correct the inability to style upload buttons in iOS and Safari.
 * 2. Change font properties to `inherit` in Safari.
 */

::-webkit-file-upload-button {
  -webkit-appearance: button; /* 1 */
  font: inherit; /* 2 */
}

/**
 * Remove the inner border and padding of focus outlines in Firefox.
 */

::-moz-focus-inner {
  border-style: none;
  padding: 0;
}

/**
 * Restore the focus outline styles unset by the previous rule in Firefox.
 */

:-moz-focusring {
  outline: 1px dotted ButtonText;
}

/**
 * Remove the additional :invalid styles in Firefox.
 */

:-moz-ui-invalid {
  box-shadow: none;
}

/* Interactive
 * ========================================================================== */

/*
 * Add the correct display in Edge 18- and IE.
 */

details {
  display: block;
}

/*
 * Add the correct styles in Edge 18-, IE, and Safari.
 */

dialog {
  background-color: white;
  border: solid;
  color: black;
  display: block;
  height: -moz-fit-content;
  height: -webkit-fit-content;
  height: fit-content;
  left: 0;
  margin: auto;
  padding: 1em;
  position: absolute;
  right: 0;
  width: -moz-fit-content;
  width: -webkit-fit-content;
  width: fit-content;
}

dialog:not([open]) {
  display: none;
}

/*
 * Add the correct display in all browsers.
 */

summary {
  display: list-item;
}

/* Scripting
 * ========================================================================== */

/**
 * Add the correct display in IE 9-.
 */

canvas {
  display: inline-block;
}

/**
 * Add the correct display in IE.
 */

template {
  display: none;
}

/* User interaction
 * ========================================================================== */

/*
 * 1. Remove the tapping delay in IE 10.
 * 2. Remove the tapping delay on clickable elements
      in all browsers (opinionated).
*/

a,
area,
button,
input,
label,
select,
summary,
textarea,
[tabindex] {
  -ms-touch-action: manipulation; /* 1 */
  touch-action: manipulation; /* 2 */
}

/**
 * Add the correct display in IE 10-.
 */

[hidden] {
  display: none;
}

/* Accessibility
 * ========================================================================== */

/**
 * Change the cursor on busy elements in all browsers (opinionated).
 */

[aria-busy="true"] {
  cursor: progress;
}

/*
 * Change the cursor on control elements in all browsers (opinionated).
 */

[aria-controls] {
  cursor: pointer;
}

/*
 * Change the cursor on disabled, not-editable, or otherwise
 * inoperable elements in all browsers (opinionated).
 */

[aria-disabled="true"],
[disabled] {
  cursor: not-allowed;
}

/*
 * Change the display on visually hidden accessible elements
 * in all browsers (opinionated).
 */

[aria-hidden="false"][hidden] {
  display: initial;
}

[aria-hidden="false"][hidden]:not(:focus) {
  clip: rect(0, 0, 0, 0);
  position: absolute;
}

Typography

/**
 * Use the default user interface font in all browsers (opinionated).
 */

html {
  font-family:
    system-ui,
    /* macOS 10.11-10.12 */ -apple-system,
    /* Windows 6+ */ "Segoe UI",
    /* Android 4+ */ "Roboto",
    /* Ubuntu 10.10+ */ "Ubuntu",
    /* Gnome 3+ */ "Cantarell",
    /* KDE Plasma 5+ */ "Noto Sans",
    /* fallback */ sans-serif,
    /* macOS emoji */ "Apple Color Emoji",
    /* Windows emoji */ "Segoe UI Emoji",
    /* Windows emoji */ "Segoe UI Symbol",
    /* Linux emoji */ "Noto Color Emoji";
}

/**
 * Use the default monospace user interface font in all browsers (opinionated).
 */

code,
kbd,
samp,
pre {
  font-family:
    /* macOS 10.10+ */ "Menlo",
    /* Windows 6+ */ "Consolas",
    /* Android 4+ */ "Roboto Mono",
    /* Ubuntu 10.10+ */ "Ubuntu Monospace",
    /* KDE Plasma 5+ */ "Noto Mono",
    /* KDE Plasma 4+ */ "Oxygen Mono",
    /* Linux/OpenOffice fallback */ "Liberation Mono",
    /* fallback */ monospace,
    /* macOS emoji */ "Apple Color Emoji",
    /* Windows emoji */ "Segoe UI Emoji",
    /* Windows emoji */ "Segoe UI Symbol",
    /* Linux emoji */ "Noto Color Emoji";
}

Forms

/**
 * 1. Change the inconsistent appearance in all browsers (opinionated).
 * 2. Add typography inheritance in all browsers (opinionated).
 */

button,
input,
select,
textarea {
  background-color: transparent; /* 1 */
  border: 1px solid WindowFrame; /* 1 */
  color: inherit; /* 1 */
  font: inherit; /* 2 */
  letter-spacing: inherit; /* 2 */
  padding: 0.25em 0.375em; /* 1 */
}

/**
 * Change the inconsistent appearance in all browsers (opinionated).
 */

select {
  -moz-appearance: none;
  -webkit-appearance: none;
  background: url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='4'%3E%3Cpath d='M4 0h6L7 4'/%3E%3C/svg%3E") no-repeat right center / 1em;
  border-radius: 0;
  padding-right: 1em;
}

/**
 * Change the inconsistent appearance in IE (opinionated).
 */

::-ms-expand {
  display: none;
}

/**
 * Correct the inconsistent appearance in IE (opinionated).
 */

:-ms-input-placeholder {
  color: rgba(0, 0, 0, 0.54);
}