aka: how do i run this site? I will probably forget if I don’t touch it for a month, so recording here:

Site Maintenance

Editing and updating

Run eleventy: npx @11ty/eleventy --serve --quiet --incremental

Update by pushing changes to master branch on github. Netlify then builds the site and deploys it.

Site structure

Eleventy Resources


  • markdown-it-anchor
  • markdown-it-class

starting a new 11ty project

—on a computer that already has 11ty installed. abridged from the official getting started docs

cd project-directory
npm init -y
npm install --save-dev @11ty/eleventy
npx @11ty/eleventy --serve

create .eleventy.js file in root directory

add css/imgs to load in _site

module.exports = function(eleventyConfig) {


return {
passthroughFileCopy: true

restart 11ty to see these changes npx @11ty/eleventy --serve

Git Cheatsheet

I use GitHub Desktop, but on occasion when I need to do something specific and have to use the terminal:

Copying a file from one branch to another

git checkout master -- posts/2022/

This takes the posts/2022/ file from master and copies it over to the current branch.