fix: typos, etc.

Author: agoose77

content/embeds.md

@@ -1,6 +1,6 @@
 # Embeds
 
-MyST This supports embedding of notebook content and other files. The following are some examples using the embed directive. 
+MyST supports embedding of notebook content and other files. The following are some examples using the @xref:guide#directive-embed.
 
 ## A Matplotlib Output
 
@@ -25,7 +25,6 @@ MyST This supports embedding of notebook content and other files. The following
 
 ![](#eqn-mlp)
 
-
 ## Embed a manual equation
 
 ![](#eqn-manual)
@@ -44,4 +43,4 @@ MyST This supports embedding of notebook content and other files. The following
 
 ## Embed a cell with multiple outputs
 
-![](#out-multiple)
+![](#out-multiple)

content/external.md

@@ -2,7 +2,6 @@
 
 MyST Supports cross-referencing into external content in order to create figures and embeds. External content could be in a different version of the AST and would need special handling.
 
-
 ## An External Figure!
 
 ![](xref:guide#img:altair-horsepower)
@@ -17,23 +16,17 @@ MyST Supports cross-referencing into external content in order to create figures
 ::::{tip} On local testing
 :class: dropdown
 
-
-1. get test source content in `folderA`
-  * myst start --execute --headless
-  * content server running on `localhost:3100`
-2. start myst-theme e.g. `npm run theme:book`
-  * theme running on `localhost:3000`
-3. get second set of test content in `folderB`
-  * add `local: http://localhost:3000` to `myst.yml#project.references`
-  * add external cross references and embeds in `folderB` pointing to the local content in `folderA`
-  * `myst start --execute --headless`
-  * content server running on `localhost:3101`
-4. in a second `myst-theme` folder, or without fully restarting the theme from step 2
-  * add a `.env` file to `themes/book`
-  * add `CONTENT_CDN_PORT=3101`
-  * `npm run theme:book`
-  * theme running on `localhost:3001`
-  * test this website 👆
+1. Get test source content in `folderA`
+   `myst start --execute --headless` starts a content server running on `localhost:3100`.
+2. Start `myst-theme`
+   `npm run theme:book` in the MyST Theme repository, e.g. `npm run theme:book` starts a theme running on `localhost:3000`.
+3. Get second set of test content in `folderB`
+   1. Add `local: http://localhost:3000` to `myst.yml#project.references`.
+   2. Add external cross references and embeds in `folderB` pointing to the local content in `folderA`.
+   3. Start a second content server with `myst start --execute --headless`, which runs on `localhost:3101`.
+4. In a second `myst-theme` folder, or without fully restarting the theme from step 2.
+   - Set `CONTENT_CDN_PORT=3101` in your environment, and run another MyST Theme process (see (2))
+5. Test this website 👆.
 
 ::::
 
@@ -48,5 +41,5 @@ MyST Supports cross-referencing into external content in order to create figures
 
 ## cross references
 
-* [To a notebook cell](xref:local#out:simple-matplotlib)
-* [To a figure](xref:local#fig:simple-matplotlib)
+- [To a notebook cell](xref:local#out:simple-matplotlib)
+- [To a figure](xref:local#fig:simple-matplotlib)

content/figures-w-placeholders.md

@@ -52,5 +52,5 @@ An ipywidgets figure with a placeholder
 :::{figure} #out-multiple
 :label: fig-multiple-pl
 :placeholder: ./placeholder.jpg
-A notebook cell with mulitple outputs of differing mimetypes and a placeholder
+A notebook cell with multiple outputs of differing mimetypes and a placeholder
 :::

content/figures.md

@@ -44,5 +44,5 @@ An ipywidgets figure
 
 :::{figure} #out-multiple
 :label: fig-multiple
-A notebook cell with mulitple outputs of differeing mimetypes
+A notebook cell with multiple outputs of differeing mimetypes
 :::