diff --git a/docs/directives.md b/docs/directives.md
index 4e6357b..66d2770 100644
--- a/docs/directives.md
+++ b/docs/directives.md
@@ -10,7 +10,7 @@ is the same as
 
 	REPT 8 { dc.b 1<<rept }
 
-Some directives change behavior based on command line options, such as -endm, -xrefimp, -kickasm and -merlin.
+Some directives change behavior based on [command line options](command_line_options.md), such as -endm, -xrefimp, -kickasm and -merlin.
 
 
 ## CPU, PROCESSOR
diff --git a/docs/macro_samples.md b/docs/macro_samples.md
index 9b7d5ef..937e8d5 100644
--- a/docs/macro_samples.md
+++ b/docs/macro_samples.md
@@ -1,6 +1,6 @@
 # x65macro.i
 
-This is a file under macros and is intended as an example to look at for understanding macro features, it is not super tested for correctness. This information is included in the header file itself but to ease reading copied here. The macros folder also has more detailed documentation.
+This is a file under macros and is intended as an example to look at for understanding macro features, it is not super tested for correctness. This information is included in the header file itself but to ease reading copied here. The macros folder also has [more detailed documentation](../macros/README.MD).
 
 ## Suffix definition
 
diff --git a/docs/readme.md b/docs/readme.md
index b71c3cb..e3e6e34 100644
--- a/docs/readme.md
+++ b/docs/readme.md
@@ -37,12 +37,12 @@ result.
 
 ## Command Line Options
 
-See [command_line_options.md]
+See [Command Line Options](command_line_options.md)
 
 ## Directives
 
-See [directives.md]
+See [Directives](directives.md)
 
 ## Macro examples
 
-See [macro_samples.md]
\ No newline at end of file
+See [Macro Samples](macro_samples.md)
\ No newline at end of file