diff --git a/README.md b/README.md
index 931348dd..e7ccabb7 100644
--- a/README.md
+++ b/README.md
@@ -58,3 +58,62 @@ Pull-requests are welcome. The goal of this repo is not to create a Neovim confi
 * Lazy-loading. Kickstart.nvim should start within 40 ms on modern hardware. Please profile and contribute to upstream plugins to optimize startup time instead.
 
 Each PR, especially those which increase the line count, should have a description as to why the PR is necessary.
+
+## Adding Grammarly and Marksman
+
+### Requirements
+
+Use the VS Code Grammarly plugin:
+
+- clone [znck/grammarly](https://github.com/znck/grammarly)
+- run the install and build commands:
+  ```bash
+  pnpm install
+  pnpm run build
+  ```
+- run the pnpmm test and verify that markdown passes
+  ```bash
+  pnpm test
+  ```
+  ```text
+  > @ test /home/droscigno/GitHub/grammarly
+  > jest
+
+   PASS  packages/grammarly-richtext-encoder/test/markdown.test.ts
+    markdown
+      ✓ encode (76 ms)
+      ✓ decode (1 ms)
+
+  Test Suites: 1 passed, 1 total
+  Tests:       2 passed, 2 total
+  Snapshots:   2 passed, 2 total
+  Time:        0.344 s, estimated 2 s
+  Ran all test suites.
+  ```
+- find the binary file `grammarly-languageserver` in a subdir of the `znck/grammarly` repo
+  ```bash
+  find . | grep "bin\/grammarly-languageserver"
+  ```
+  ```response
+  ./extension/node_modules/.bin/grammarly-languageserver
+  ```
+  Run the languageserver to make sure it starts:
+  ```bash
+  ./extension/node_modules/.bin/grammarly-languageserver --stdio
+  ```
+  ```response
+  Content-Length: 85
+  
+  {"jsonrpc":"2.0","method":"window/logMessage","params":{"type":4,"message":"Ready!"}}^C
+  ```
+## Configure neovim
+
+- remove $HOME/.config/nvim
+- link this repo to $HOME/.config/nvim
+- edit `lua/grammarly.lua` and set the Grammarly LSP cmd (using the one you just built in the `znck/grammarly` dir)
+
+## Test
+- edit a markdown file (this one will show some issues). You should see marks in the far left column indicating grammar and spelling errors. Navigate through the errors with `]d`
+- add a link to a non-existent markdown file, for example, `[foo](./foo.md)`.  This will show as a warning from Marksman if you add it outside of a code block.
+[foo](./foo.md)
+