Rafael "Brodinho" Guimarães rgcs88

My Pandoc Markdown-PDF Workflow for Routine, Not Especially Technical, Writing

by Danny Quah, Aug 2020 (revised Jan 2022)

TL;DR: I write technical articles in LaTeX. But shorter, non-technical writings are easier to do in Markdown. How do I produce PDF from Markdown documents? Answer: provide YAML information in the Markdown; run Pandoc (typically through a Makefile or Atom's Markdown Preview Enhanced). To make all this work, some adjustment is needed in Pandoc options and template files.

Pandoc is a filter that takes a written document in a particular format, and produces a version of that same document in yet a different format. I use Pandoc primarily to transform Markdown documents to PDF, but I also draw on Pandoc to convert Word or ODT documents to Markdown. And vice versa.

Available official Pandoc documentation is voluminous. So as a matter of logic the knowledge to generate PDF from Markdown, to the user's desired degree of control, is already extant, out there somewhere. But a user j

I wrote this down after I responded to a page today (a holiday) because it would've been a decent pairing opportunity for a couple of new people on my team. Second best is that people can read what I did afterwards and ask me any questions. And then I realized that there's nothing PagerDuty-specific or confidential in here, so I may as well share it wider. It's hardly an epic incident, but it's a good example of "doing the work", I think. I borrowed the "write down what you learned" approach from Julia "b0rk" Evans. It's a fantastic practice.

The PagerDuty incident: "Disk will be full in 12 hours. device:/dev/nvme0n1p1, host:stg-nomadusw2-client-..."

(Note for non-PD readers: We run Nomad where others might run Kubernetes.)

Here's the process I went through.

Noticed that the usual docker system prune -a -f didn't resolve it
Tried docker system prune -a -f and it cleared up 0B

	const http = require('http');
	const server = http.createServer();

	server.on('request', (request, response) => {
	let body = [];
	request.on('data', (chunk) => {
	body.push(chunk);
	}).on('end', () => {
	body = Buffer.concat(body).toString();

	import { useRef, useEffect } from "react";

	type Timer = ReturnType<typeof setTimeout>;
	type SomeFunction = (...args: any[]) => void;
	/**
	*
	* @param func The original, non debounced function (You can pass any number of args to it)
	* @param delay The delay (in ms) for the function to return
	* @returns The debounced function, which will run only if the debounced function has not been called in the last (delay) ms
	*/

	# $HOME/.config/alacritty/alacritty.toml
	# by Rito Ghosh 2023-10-06

	# Alacritty now uses TOML formatting for its config files.
	# This is a simple example.

	# There are the specification here: https://github.com/alacritty/alacritty/blob/master/extra/man/alacritty.5.scd
	# It is not obvious how it translates to TOML. But it is extremely straightforward.

	# example: WINDOW, COLORS, etc. are tables, and should be represented as [window], [colors], respectively.

	sudo update-alternatives --install /usr/bin/x-terminal-emulator x-terminal-emulator $(which alacritty) 50
	sudo update-alternatives --config x-terminal-emulator