Awesome Open Source
Awesome Open Source


GitHub Issues Forks GitHub Stars License

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.



  1. Start by making a new private repository from this template. Make sure you make it private
  2. Edit and add your OS-ID to OSID="".
  3. Run to install necessary tools and libraries (tested on ParrotOS), edit first if you don't want to install all of LaTeX.
  4. Edit the report.mdpp files and add your own information.
  5. Then simply write your report in markdown.
  6. Run 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

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):


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


Based on

noraj OSCP-Exam-Report-Template-Markdown ((LICENSE)):

Inspired by

JohnHammond oscp-notetaking (UNLICENSED):

Report Template

whoisflynn improved template v3.2 (UNLICENSED):

Pandoc Template

Eisvogel (LICENSE):

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Shell (232,179
Template (7,718
Markdown (6,589
Report (672
Pandoc (520
Exam (342
Oscp (187
Offensive Security (168
Related Projects