diff --git a/site/content/docs/01-component-format.md b/site/content/docs/01-component-format.md
index 10fd8e5ebc..f001fee6aa 100644
--- a/site/content/docs/01-component-format.md
+++ b/site/content/docs/01-component-format.md
@@ -96,6 +96,9 @@ If a statement consists entirely of an assignment to an undeclared variable, Sve
 ```html
 <script>
 	export let num;
+
+	// we don't need to declare `squared` and `cubed`
+	// — Svelte does it for us
 	$: squared = num * num;
 	$: cubed = squared * num;
 </script>
diff --git a/site/content/docs/02-template-syntax.md b/site/content/docs/02-template-syntax.md
index 896278a524..954ede631c 100644
--- a/site/content/docs/02-template-syntax.md
+++ b/site/content/docs/02-template-syntax.md
@@ -496,6 +496,8 @@ To get a reference to a DOM node, use `bind:this`.
 
 * `bind:property={value}`
 
+---
+
 You can bind to component props using the same mechanism.
 
 ```html
@@ -506,7 +508,7 @@ You can bind to component props using the same mechanism.
 
 Components also support `bind:this`, allowing you to interact with component instances programmatically.
 
-(Note that we can do `{cart.empty}` rather than `{() => cart.empty()}`, since component methods are closures. You don't need to worry about the value of `this` when calling them.)
+> Note that we can do `{cart.empty}` rather than `{() => cart.empty()}`, since component methods are closures. You don't need to worry about the value of `this` when calling them.
 
 ```html
 <ShoppingCart bind:this={cart}/>