diff --git a/guide/src/SUMMARY.md b/guide/src/SUMMARY.md index 3ae143fb87..7848743eb2 100644 --- a/guide/src/SUMMARY.md +++ b/guide/src/SUMMARY.md @@ -17,7 +17,7 @@ - [Syntax highlighting](format/theme/syntax-highlighting.md) - [Editor](format/theme/editor.md) - [MathJax Support](format/mathjax.md) - - [mdBook specific features](format/mdbook.md) + - [mdBook-specific features](format/mdbook.md) - [Continuous Integration](continuous-integration.md) - [For Developers](for_developers/README.md) - [Preprocessors](for_developers/preprocessors.md) diff --git a/guide/src/format/mdbook.md b/guide/src/format/mdbook.md index 223ba2159d..f9dc7256f6 100644 --- a/guide/src/format/mdbook.md +++ b/guide/src/format/mdbook.md @@ -1,9 +1,9 @@ -# mdBook-specific markdown +# mdBook-specific features ## Hiding code lines There is a feature in mdBook that lets you hide code lines by prepending them -with a `#` [in the same way that Rustdoc does][rustdoc-hide]. +with a `#` [like you would with Rustdoc][rustdoc-hide]. [rustdoc-hide]: https://doc.rust-lang.org/stable/rustdoc/documentation-tests.html#hiding-portions-of-the-example @@ -37,7 +37,7 @@ With the following syntax, you can include files into your book: The path to the file has to be relative from the current source file. -mdBook will interpret included files as markdown. Since the include command +mdBook will interpret included files as Markdown. Since the include command is usually used for inserting code snippets and examples, you will often wrap the command with ```` ``` ```` to display the file contents without interpretting them. diff --git a/guide/src/format/theme/syntax-highlighting.md b/guide/src/format/theme/syntax-highlighting.md index 97ed890967..a0c609f8bf 100644 --- a/guide/src/format/theme/syntax-highlighting.md +++ b/guide/src/format/theme/syntax-highlighting.md @@ -1,7 +1,7 @@ # Syntax Highlighting -For syntax highlighting we use [Highlight.js](https://highlightjs.org) with a -custom theme. +mdBook uses [Highlight.js](https://highlightjs.org) with a +custom theme for syntax highlighting. Automatic language detection has been turned off, so you will probably want to specify the programming language you use like this: