diff --git a/docs/src/content/introduction/index.md b/docs/src/content/introduction/index.md
index 6a2b46201..8e137a682 100644
--- a/docs/src/content/introduction/index.md
+++ b/docs/src/content/introduction/index.md
@@ -23,7 +23,7 @@ In this guide, we’ll show you how to get started with Victory and walk you thr
 
 You can do this on your own if you'd like, or you can...
 
-* Clone down [this project we've started for you](https://github.com/FormidableLabs/victory-tutorial) using ```git clone git@github.com:FormidableLabs/victory-tutorial.git```
+* Clone down [this project we've started for you](https://github.com/FormidableLabs/victory-tutorial) using `git clone git@github.com:FormidableLabs/victory-tutorial.git`
 * `cd victory-tutorial`
 * Replace the existing code in the `client.js` file with:
 
@@ -153,6 +153,8 @@ class App extends React.Component {
 ReactDOM.render(<App/>, mountNode);
 ```
 
+While the axes defaults are great, you can see there's some overlap with the y-axis and first bar. Let's fix that in the next section.
+
 #### 6. Customize the axes
 
 Next, let's modify the tick labels on the axes to be a little more descriptive. We can do this by adding and configuring `VictoryAxis` components to our chart, so let's import `VictoryAxis`. Import statements should now look like this:
diff --git a/docs/src/partials/markdown/index.js b/docs/src/partials/markdown/index.js
index 94bb608ca..05f0ed8db 100644
--- a/docs/src/partials/markdown/index.js
+++ b/docs/src/partials/markdown/index.js
@@ -113,6 +113,7 @@ export function renderHeading(props) {
   const slug = text
     .trim()
     .toLowerCase()
+    .replace(/^\d+\.\s*/, "") // remove leading numbers and periods
     .replace(/[^\w\- ]/g, "") // Remove punctuation
     .replace(/\s+/g, "-"); // Replace spaces with a dash
 
@@ -144,7 +145,6 @@ renderHeading.propTypes = {
  * @param {Object} meta - meta
  * @returns {Object} link element
  */
-// eslint-disable-next-line react/no-multi-comp
 export const renderLink = ({ href, children }) => {
   if (/^\w+:/.test(href)) {
     return (
@@ -161,7 +161,7 @@ renderLink.propTypes = {
   href: PropTypes.string,
 };
 
-/* eslint-enable react/prop-types, no-magic-numbers */
+/* eslint-enable no-magic-numbers */
 const Markdown = (props) => {
   const { className, source, scope, theme } = props;
   /* eslint-disable react/prop-types, no-magic-numbers */