A Specimen Sheet - Reader

C:\Desktop\Articles\

A Specimen Sheet

Every element an article on this site can use, set in one place, the way a type foundry shows off a typeface.

2 min read

Type foundries used to print specimen sheets: one page showing a typeface doing everything it could do. This is the same idea for this site. It is a starter article, and a reference to copy from when writing a real one.

Paragraphs and emphasis

Body text is set in a serif at a comfortable measure. You can use italics for emphasis, bold for the rare thing that must not be missed, inline code for anything typed literally, and strikethrough for corrections you want to leave visible.

Links come in two kinds. One points somewhere else on this site. The other points out to the wider internet, is marked with an arrow, and never sends a referrer.

Lists

Unordered, for things with no sequence:

  • Reconnaissance
  • Initial access
    • Phishing
    • Exposed services
  • Persistence

Ordered, for things that have one:

  1. Form a hypothesis.
  2. Design the smallest test that could prove it wrong.
  3. Run it, and write down what happened rather than what you expected.

Quotations

A blockquote is for someone else’s words. Set them apart, name the source, and keep them short enough that the reader remembers whose article this is.

Code

Fenced code blocks open in a small console window. Name the language after the opening fence to get syntax colors.

python
import hashlib

def fingerprint(path: str) -> str:
    """Return the SHA-256 digest of a file, read in chunks."""
    digest = hashlib.sha256()
    with open(path, "rb") as handle:
        for block in iter(lambda: handle.read(65536), b""):
            digest.update(block)
    return digest.hexdigest()
bash
# verify a download against its published checksum
sha256sum --check release.sha256

Tables

ControlCostStops
Hardware security keyLowMost phishing
Patching on a scheduleMediumKnown exploits
Network segmentationHighLateral movement

Footnotes and rules

A claim that needs a source gets a footnote.1 A change of subject gets a rule.


Smaller headings

Third-level headings divide a section without starting a new one.

Labels

Fourth-level headings are small labels, best used sparingly.


  1. Footnotes collect at the end of the article, with a link back to where you were reading. ↩︎