From 2d36cd9263ab7867efc7e8a91dc533338febeda1 Mon Sep 17 00:00:00 2001
From: josh rotenberg <joshrotenberg@users.noreply.github.com>
Date: Sat, 18 Dec 2021 16:00:46 -0800
Subject: [PATCH] more markdown

---
 guide/src/format/markdown.md | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/guide/src/format/markdown.md b/guide/src/format/markdown.md
index 7e807af7..74ecaf56 100644
--- a/guide/src/format/markdown.md
+++ b/guide/src/format/markdown.md
@@ -68,6 +68,22 @@ Lists can be unordered or ordered. Ordered lists will order automatically:
 
 ## Links
 
+Linking to a URL or local file is easy:
+
+```markdown
+Use [mdBook](https://github.com/rust-lang/mdBook). 
+
+Read about [mdBook](mdBook.md).
+
+A bare url: <https://www.rust-lang.org>.
+```
+
+Use [mdBook](https://github.com/rust-lang/mdBook). 
+
+Read about [mdBook](mdBook.md).
+
+A bare url: <https://www.rust-lang.org>.
+
 ## Images
 
 Including images is simply a matter of including a link to them, much like in the _Links_ section above. The following markdown
@@ -87,4 +103,5 @@ Which, of course displays the image like so:
 
 ![The Rust Logo](images/rust-logo-blk.svg)
 
-## Lists
+
+See the [Markdown Guide Basic Syntax](https://www.markdownguide.org/basic-syntax/) document for more.