OSCP-Exam-Report-Template

This is my OSCP exam notes template, based on the fine work by noraj in his OSCP-Exam-Report-Template-Markdown (LICENSE)

This allow fast and efficient note writing during both the labs and the exam.

Instead of one huge report file, this template is based on several smaller markdown files, which are stitched together using MarkdownPP before generating the final report with Pandoc.

The report text is the whoisflynn improved version of the official PWK Example Report.

Requirements

MarkdownPP
Pandoc
LaTeX (eg. TeX Live) in order to get pdflatex or xelatex
Eisvogel Pandoc LaTeX PDF Template

Usage

Start by making a new private repository from this template. Make sure you make it private
Edit generate-package.sh and add your OS-ID to OSID="".
Run install-tools.sh to install necessary tools and libraries (tested on ParrotOS), edit first if you don’t want to install all of LaTeX.
Edit the report.mdpp files and add your own information.
Then simply write your report in markdown.
Run generate-package.sh to generate report PDFs and report package.

Exercises and targets

Add exercises to the Lab/Exercises directory, save as .md files. Prefix the file with the chapter number, to ensure that the exercises will be included in the correct order.

Add targets in Lab/Targets and Exam/Targets, save as .md files.

Adjust to your needs

You can change the code syntax highlight theme by modifying --highlight-style in generate-report.sh.

Color sets

Well rendering color sets you can use in the template YAML:

titlepage-color	titlepage-text-color	titlepage-rule-color
`DC143C` (Crimson)	`FFFFFF` (White)	`FFFFFF` (White)
`00FF7F` (SpringGreen)	`006400` DarkGreen	`000000` (Black)
`1E90FF` (DodgerBlue)	`FFFAFA` (Snow)	`FFFAFA` (Snow)
`483D8B` (DarkSlateBlue)	`FFFAFA` (Snow)	`FFFAFA` (Snow)
`FFD700` (Gold)	`000000` (Black)	`000000` (Black)
`FFEFD5` (PapayaWhip)	`000000` (Black)	`000000` (Black)
`FF8C00` (DarkOrange)	`000000` (Black)	`000000` (Black)
`FFEF96` (no name)	`50394C` (no name)	`50394C` (no name)

VS Code

VS Code is a very good editor, and it is also a very good Markdown editor! The following extensions will make it even better (better for more than just Markdown):

Github Markdown Preview - bierner.github-markdown-preview
markdownlint - davidanson.vscode-markdownlint
Markdown Paste - telesoho.vscode-markdown-paste-image
Markdown Navigate - jrieken.md-navigate
Markdown All in One - yzhang.markdown-all-in-one
Word Count - ms-vscode.wordcount
Markdown PDF - yzane.markdown-pdf
Code Spell Checker - streetsidesoftware.code-spell-checker
GitLens — Git supercharged - eamodio.gitlens
PowerShell - ms-vscode.PowerShell
Python - ms-python.python
Ruby - rebornix.Ruby
C/C++ - vscode.cpptools
vscode-icons - vscode-icons-team.vscode-icons
Polacode - pnp.polacode
vscode-pdf - tomoki1207.pdf
hexdump for VSCode - slevesque.vscode-hexdump

Fonts

To make it even better, install Fira Code and Noto Color Emoji:

FiraCode - sudo apt install fonts-firacode
Noto Color Emoji - sudo apt install fonts-noto-color-emoji

VSCode settings.json

{
  "telemetry.enableTelemetry": false,
  "telemetry.enableCrashReporter": false,
  "editor.formatOnSave": true,
  "workbench.iconTheme": "vscode-icons",
  "editor.fontFamily": "Fira Code,Noto Color Emoji",
  "editor.fontSize": 14,
  "editor.fontLigatures": true,
  "markdown-pdf.executablePath": "/opt/google/chrome/chrome",
  "editor.codeActionsOnSave": {
    "source.fixAll.markdownlint": true
  }
}

Known issues

MarkdownPP has a bug that will break include statements inside C-code blocks. This bug has been fixed in this fork: https://github.com/miguelangelnieto/markdown-pp

Credits