Markdown PDF Styles

Use preset styles:
- Classic: Report, Letter, Resume
- Academic: IEEE, APA
- Others: Cheatsheet
Or customize using barebone styles:
- Font
- Text
- Indent
- Spacing
- Column
- Others
Optional headers & footers:
- Webpage
- Homework

Usage

To use the style, modify VSCode user settings.json according to the style below. A root project directory may also have .vscode/settings.json for project-wide preferences, which will override global settings.

Preset styles

Report

Replace variable $TITLE to report's title.

::: attributions
Urna Semper<br>Instructor’s Name<br>March 13, 2023
:::

::: title
Geology 101 Report
:::

::: subtitle
Sed et lacus quis enim mattis nonummy
:::

Lorem ipsum...

Letter

::: sender
Sender Name
:::

::: contact
1234 Main Street<br>Anytown, State ZIP<br>123-456-7890<br>no_reply@example.com
:::

29 April 2023

::: recipient
Recipient Name<br>4321 First Street<br>Anytown, State ZIP
:::

Lorem ipsum...

Resume

::: name
Your Name
:::

::: job
Job Title
:::

# Profile

Lorem ipsum...

::: contact
1234 Main Street Anytown, State ZIP&emsp;123-456-7890<br>no_reply@example.com&emsp;@social_media
:::

IEEE

IEEE style is an academic paper format with double column and serif font.

::: title
Paper Title* (use style: *paper title*)
:::

::: authors
Given Name Surname<br>
*dept. name of organization (of Affiliation)*<br>
City, Country<br>
email address or ORCID
:::

:::: content
Lorem ipsum...

::: references
1.  Awesome article
1.  Awesome website
:::
::::

APA

APA style is an academic paper format with sans serif font.

Replace variable $TITLE to article's title.

::: title
Paper Title
:::

::: subtitle
Author Name<br>
Department of Psychology, The George Washington University<br>
Instructor Name<br>
:::

Lorem ipsum...

::: references
Awesome article

Awesome website
:::

Cheatsheet

Keep as many content as possible with mini everything.

Custom styles

Only pick at maximum one in each category.

Font

Sans	Serif

Font family stylesheets with Noto Sans/Serif and JetBrains Mono, the default is system fonts.

{
  "markdown-pdf.styles": [
    ".../markdown-pdf-styles/styles/font-sans.css",
    ".../markdown-pdf-styles/styles/font-serif.css",
  ],
}

Text

Small	Normal

Text and code size stylesheets, the default is around 12pt.

{
  "markdown-pdf.styles": [
    ".../markdown-pdf-styles/styles/text-small.css",
    ".../markdown-pdf-styles/styles/text-normal.css",
  ],
}

Indent

Quarter	Half

Paragrah indentation and justification stylesheets, there is no indent by default.

{
  "markdown-pdf.styles": [
    ".../markdown-pdf-styles/styles/indent-quarter.css",
    ".../markdown-pdf-styles/styles/indent-half.css",
  ],
}

Spacing

Single	Double

Line height stylesheets, the default is around one-half inch.

{
  "markdown-pdf.styles": [
    ".../markdown-pdf-styles/styles/spacing-single.css",
    ".../markdown-pdf-styles/styles/spacing-double.css",
  ],
}

Column

Two	Three	Four

Column splitting stylesheets, the default is full column.

{
  "markdown-pdf.styles": [
    ".../markdown-pdf-styles/styles/column-two.css",
    ".../markdown-pdf-styles/styles/column-three.css",
    ".../markdown-pdf-styles/styles/column-four.css",
  ],
}

Others

Reference

A hotfix to prevent sup and sub for affecting line height.

{
  "markdown-pdf.styles": [
    ".../markdown-pdf-styles/styles/reference.css",
  ],
}

Headers & footers

Template for header and footer needs to be embedded in the settings.

Webpage

Header	Footer

Replace variable $URL to webpage link, $TITLE with document title.

{
  "markdown-pdf.headerTemplate": "<div style='font-size: 7pt; margin-left: 1cm; margin-right: 1cm;'> <span>$URL</span> </div>",
  "markdown-pdf.footerTemplate": "<div style='font-size: 7pt; margin-left: 1cm;'> <span>$TITLE</span> </div> <div style='font-size: 7pt; margin-left: auto; margin-right: 1cm;'> <span class='pageNumber'></span> / <span class='totalPages'></span> </div>",
}

Homework

Header	Footer

Replace variable $SUBJECT to student credential, $IMAGE_BASE64 to school logo (10px height), $TITLE to document title.

{
  "markdown-pdf.headerTemplate": "<div style='font-size: 7pt; margin-left: 1cm;'> <span>$SUBJECT</span> </div> <div style='margin-left: auto; margin-right: 1cm;'> <img src='$IMAGE_BASE64'> </div>",
  "markdown-pdf.footerTemplate": "<div style='font-size: 7pt; margin-left: 1cm;'> <span>$TITLE</span> </div> <div style='font-size: 7pt; margin-left: auto; margin-right: 1cm;'> <span class='pageNumber'></span> / <span class='totalPages'></span> </div>",
}

markdown-pdf-styles

Commits

Indent styles affect ordered and unordered list paragraph justification

Shift IEEE image left for figures

Add optional style to disable indentation

Define small tag font size

Use Lucon and Cour for APA and IEEE code respectively

Updated IEEE and APA ids, remove MLA altogether

README