<p>Let’s create our first content file for your documentation. Open a terminal and add the following command for each new file you want to add. Replace <code><section-name></code> with a general term that describes your document in detail.</p>
<pre><codeclass="language-sh">hugo new <section-name>/filename.md
</code></pre>
<p>Visitors of your website will find the final document under <code>www.example.com/<section-name>/filename/</code>.</p>
<p>Since it’s possible to have multiple content files in the same section I recommend to create at least one <code>index.md</code> file per section. This ensures that users will find an index page under <code>www.example.com/<section-name></code>.</p>
<h2id="homepage">Homepage</h2>
<p>To add content to the homepage you need to add a small indicator to the frontmatter of the content file:</p>
<pre><codeclass="language-toml">type: index
</code></pre>
<p>Otherwise the theme will not be able to find the corresponding content file.</p>
<h2id="table-of-contents">Table of contents</h2>
<p>You maybe noticed that the menu on the left contains a small table of contents of the current page. All <code><h2></code> tags (<code>## Headline</code> in Markdown) will be added automatically.</p>
<h2id="admonitions">Admonitions</h2>
<p>Admonition is a handy feature that adds block-styled side content to your documentation, for example hints, notes or warnings. It can be enabled by using the corresponding <ahref="http://gohugo.io/extras/shortcodes/">shortcodes</a> inside your content:</p>
<p>Let&rsquo;s create our first content file for your documentation. Open a terminal and add the following command for each new file you want to add. Replace <code>&lt;section-name&gt;</code> with a general term that describes your document in detail.</p>
<pre><code class="language-sh">hugo new &lt;section-name&gt;/filename.md
</code></pre>
<p>Visitors of your website will find the final document under <code>www.example.com/&lt;section-name&gt;/filename/</code>.</p>
<p>Since it&rsquo;s possible to have multiple content files in the same section I recommend to create at least one <code>index.md</code> file per section. This ensures that users will find an index page under <code>www.example.com/&lt;section-name&gt;</code>.</p>
<p>To add content to the homepage you need to add a small indicator to the frontmatter of the content file:</p>
<pre><code class="language-toml">type: index
</code></pre>
<p>Otherwise the theme will not be able to find the corresponding content file.</p>
<h2 id="table-of-contents">Table of contents</h2>
<p>You maybe noticed that the menu on the left contains a small table of contents of the current page. All <code>&lt;h2&gt;</code> tags (<code>## Headline</code> in Markdown) will be added automatically.</p>
<p>Admonition is a handy feature that adds block-styled side content to your documentation, for example hints, notes or warnings. It can be enabled by using the corresponding <a href="http://gohugo.io/extras/shortcodes/">shortcodes</a> inside your content:</p>