diff --git a/README.md b/README.md
index 067684590..dbd269c61 100644
--- a/README.md
+++ b/README.md
@@ -2,28 +2,45 @@
    
-This repository holds the source code for [Forgetful Notes](https://forgetfulnotes.com)βmy digital garden of knowledge. It serves as a platform for my learning and creative endeavours. A space for thinking through, building upon, and coming back to.
+[Forgetful Notes](https://forgetfulnotes.com) is my _digital garden_ of knowledge. It serves as a platform for my learning and creative endeavours. A space for thinking through, building upon, and coming back to.
-It is powered by [Quartz](https://github.com/jackyzha0/quartz/) and [Obsidian](https://obsidian.md). You can read the [Documentation](https://quartz.jzhao.xyz/), and join the [Discord Community](https://discord.gg/cRFFHYye7t).
+[](https://semanticdata.github.io/eleventy-notes/)
+[](https://eleventy-notes-chi.vercel.app)
-## Contents
-
-
-Show/Hide
+## π Table of Contents
- [π± Forgetful Notes](#-forgetful-notes)
- - [Contents](#contents)
- - [Features](#features)
- - [Background](#background)
- - [Technology](#technology)
- - [Useful Commands](#useful-commands)
- - [Customization](#customization)
- - [Folder Structure](#folder-structure)
- - [License](#license)
+ - [π Table of Contents](#-table-of-contents)
+ - [β‘ Quick start](#-quick-start)
+ - [β¨ Features](#-features)
+ - [π Background](#-background)
+ - [π¨πΌβπ» Useful Commands](#-useful-commands)
+ - [π¨ Customization](#-customization)
+ - [π Folder Structure](#-folder-structure)
+ - [π οΈ Technology](#οΈ-technology)
+ - [Β© License](#-license)
-
+## β‘ Quick start
-## Features
+**1. Clone repo**
+
+```bash
+git clone https://github.com/semanticdata/forgetful-notes.git
+```
+
+**2. Install dependencies**
+
+```sh
+pnpm install
+```
+
+**3. Run the project locally**
+
+```sh
+pnpm start
+```
+
+## β¨ Features
- Fast Natural-Language Search
- Bidirectional Backlinks
@@ -32,44 +49,57 @@ It is powered by [Quartz](https://github.com/jackyzha0/quartz/) and [Obsidian](h
- Markdown Links and Wikilinks Support
- Latex Support
-## Background
+## π Background
Forgetful Notes is created using [Quartz](https://github.com/jackyzha0/quartz), hosted on [GitHub](https://github.com/), deployed with [GitHub Pages](https://pages.github.com/), and facilitated by the GitHub [Publisher](https://github.com/ObsidianPublisher) plugin for [Obsidian](https://obsidian.md/).
The website has gone through many changes. I have not been shy about moving from technology to technology as I learn new things. Coming across the world of _Static Site Generators_ was a game changer. I have ran my notes through [Jekyll](https://jekyllrb.com/), [Hugo](https://gohugo.io/), [MkDocs](https://squidfunk.github.io/mkdocs-material/), [Zola](https://www.getzola.org/), and most recently [11ty](https://11ty.dev).
-## Technology
+## π¨πΌβπ» Useful Commands
-All content for the site is written in _Markdown_ within [Obsidian](https://obsidian.md/)βan extensible, flexible note-taking app. To export the notes from Obsidian, I rely on the [GitHub Publisher](https://github.com/ObsidianPublisher) plugin.
-
-The [source code](https://github.com/semanticdata/forgetful-notes) is hosted in [GitHub](https://github.com/). From here we use [GitHub Actions](https://github.com/features/actions) to build and deploy the site to [GitHub Pages](https://pages.github.com/).
-
-## Useful Commands
+**Install dependencies**
```sh
-# Install Dependencies
npm install
+```
-# Update Dependencies
+**Update dependencies**
+
+```sh
npm update
+```
-# Start Local Server
+**Start local server**
+
+```sh
npm start
+```
-# Update Quartz
+**Update Quartz**
+
+```sh
npm run update
+```
-# Sync the Repo
+**Sync the repo**
+
+```sh
npm run sync
+```
-# Build Only
+**Build only**
+
+```sh
npm run build
+```
-# Find Help
+**Read about a command**
+
+```sh
npx quartz --help
```
-## Customization
+## π¨ Customization
### Stylesheets
@@ -77,13 +107,13 @@ You can add custom CSS code within `/quartz/styles/custom.scss`. You will then n
### Fonts
-| Used in: | Font Family | Previous Font |
-| --- | :-: | :-: |
-| Headers | [Bitter](https://fonts.google.com/specimen/Bitter) | [Schibsted Grotesk](https://fonts.google.com/specimen/Schibsted+Grotesk) |
-| Body | [Bitter](https://fonts.google.com/specimen/Bitter) | [Source Sans Pro](https://fonts.google.com/specimen/Source+Sans+3) |
-| Code | [Fira Mono](https://fonts.google.com/specimen/Fira+Mono) | [IBM Plex Mono](https://fonts.google.com/specimen/IBM+Plex+Mono) |
+| Used in: | Font Family | Previous Font |
+| -------- | :------------------------------------------------------: | :----------------------------------------------------------------------: |
+| Headers | [Bitter](https://fonts.google.com/specimen/Bitter) | [Schibsted Grotesk](https://fonts.google.com/specimen/Schibsted+Grotesk) |
+| Body | [Bitter](https://fonts.google.com/specimen/Bitter) | [Source Sans Pro](https://fonts.google.com/specimen/Source+Sans+3) |
+| Code | [Fira Mono](https://fonts.google.com/specimen/Fira+Mono) | [IBM Plex Mono](https://fonts.google.com/specimen/IBM+Plex+Mono) |
-## Folder Structure
+## π Folder Structure
Show/Hide
@@ -164,6 +194,19 @@ You can add custom CSS code within `/quartz/styles/custom.scss`. You will then n
-## License
+## π οΈ Technology
+
+The site uses various technologies cobbled together. It's powered by [Quartz](https://github.com/jackyzha0/quartz/) and [Obsidian](https://obsidian.md). You can read the [Documentation](https://quartz.jzhao.xyz/), and join the [Discord Community](https://discord.gg/cRFFHYye7t).
+
+Here's some of them:
+
+- [Quartz](https://github.com/jackyzha0/quartz): a fast, batteries-included static-site generator.
+- [Prettier](https://github.com/prettier/prettier): an opinionated code formatter.
+- [Sass](https://github.com/sass/sass): makes CSS fun!
+- [TypeScript](https://github.com/microsoft/TypeScript): superset of JavaScript that compiles to clean JavaScript output.
+
+All content for the site is written in _Markdown_ within [Obsidian](https://obsidian.md/)βan extensible, flexible note-taking app. To export the notes from Obsidian, I rely on the [GitHub Publisher](https://github.com/ObsidianPublisher) plugin.
+
+## Β© License
Source code in this repository is available under the [MIT License](LICENSE).