<h1>Something about inclusion</h1>
<h2>Literal md include</h2>
<span><div class="codehilite"><pre><span></span><span class="o">##</span> <span class="n">One</span>

<span class="n">The</span> <span class="o">**</span><span class="k">first</span><span class="o">**</span> <span class="n">one</span><span class="p">.</span>

<span class="n">This</span> <span class="k">is</span> <span class="n">a</span> <span class="p">[</span><span class="n">Link</span> <span class="k">to</span> <span class="n">two</span><span class="p">](</span><span class="n">two</span><span class="p">.</span><span class="n">md</span> <span class="ss">&quot;Title 2&quot;</span><span class="p">)</span> <span class="k">and</span> <span class="n">this</span> <span class="k">is</span> <span class="k">is</span> <span class="n">a</span> <span class="p">[</span><span class="n">link</span> <span class="k">to</span> <span class="n">three</span><span class="p">](</span><span class="n">three</span><span class="p">.</span><span class="n">md</span><span class="p">).</span>

<span class="err">{</span><span class="o">%</span> <span class="n">include</span> <span class="ss">&quot;two.md&quot;</span> <span class="o">%</span><span class="err">}</span>

<span class="o">&lt;!</span><span class="c1">-- comment --&gt;</span>

<span class="o">```</span> <span class="n">markdown</span>
<span class="p">[</span><span class="n">Link</span> <span class="k">to</span> <span class="n">two</span><span class="p">](</span><span class="n">two</span><span class="p">.</span><span class="n">md</span> <span class="ss">&quot;Title 2&quot;</span><span class="p">)</span>
<span class="o">```</span>

<span class="o">&lt;!</span><span class="c1">-- endcomment --&gt;</span>
</pre></div>
</span><h2>Literal code include</h2>
<span><div class="codehilite"><pre><span></span><span class="kn">import</span> <span class="nn">os</span>


<span class="k">def</span> <span class="nf">create_tarball_package</span><span class="p">(</span><span class="n">result_dir</span><span class="p">,</span> <span class="n">package_dir</span><span class="p">,</span> <span class="n">package_name</span><span class="p">,</span> <span class="n">package_version</span><span class="p">,</span> <span class="n">compress</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> <span class="n">codec</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span>
    <span class="n">archive_file</span> <span class="o">=</span> <span class="s1">&#39;.&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">package_name</span><span class="p">,</span> <span class="n">package_version</span><span class="p">,</span> <span class="s1">&#39;tar&#39;</span><span class="p">])</span>

    <span class="k">if</span> <span class="n">compress</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">codec</span><span class="p">:</span>
        <span class="n">archive_file</span> <span class="o">+=</span> <span class="s1">&#39;.gz&#39;</span>

    <span class="k">with</span> <span class="n">exts</span><span class="o">.</span><span class="n">tmp</span><span class="o">.</span><span class="n">temp_dir</span><span class="p">()</span> <span class="k">as</span> <span class="n">temp_dir</span><span class="p">:</span>
        <span class="n">tar_archive</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">temp_dir</span><span class="p">,</span> <span class="n">archive_file</span><span class="p">)</span>
</pre></div>
</span><h2>Rendered md include</h2>
<span><h2>One</h2><p>The <strong>first</strong> one.</p><p>This is a <a href="includes/two.md" title="Title 2">Link to two</a> and this is is a <a href="includes/three.md">link to three</a>.</p><span><h2>Two</h2><p>Text.</p><p><strong>Two too.</strong></p><p>This is a <a href="includes/one.md">Link to one</a> and this is is a <a href="includes/three.md">link to three</a>.</p><span><div class="codehilite"><pre><span></span><span class="o">##</span> <span class="n">Three</span>

<span class="nb">Text</span><span class="p">.</span>

<span class="n">Three</span> <span class="n">tree</span><span class="p">.</span> <span class="p">[</span><span class="n">Link</span> <span class="k">to</span> <span class="n">note</span><span class="p">](..</span><span class="o">/</span><span class="n">note</span><span class="p">.</span><span class="n">md</span><span class="p">)</span>

<span class="o">-</span> <span class="n">a</span>
<span class="o">-</span> <span class="n">b</span>
<span class="o">-</span> <span class="err">{</span><span class="o">%</span> <span class="n">include</span> <span class="ss">&quot;string.md&quot;</span> <span class="o">%</span><span class="err">}</span> 
</pre></div>
</span></span><!-- comment -->
<pre><code class="markdown">[Link to two](two.md &quot;Title 2&quot;)
</code></pre>
<p><!-- endcomment -->
</p></span><p>Check that simple <a href="inc_note.md">links</a> still resolve correctly after rendered include.</p>
<h2>Inline rendered include</h2>
<span><p>XXX The String XXX
</p></span><h2>Markdown-style link to included file</h2>
<span><h2>One</h2><p>The <strong>first</strong> one.</p><p>This is a <a href="includes/two.md" title="Title 2">Link to two</a> and this is is a <a href="includes/three.md">link to three</a>.</p><span><h2>Two</h2><p>Text.</p><p><strong>Two too.</strong></p><p>This is a <a href="includes/one.md">Link to one</a> and this is is a <a href="includes/three.md">link to three</a>.</p><span><div class="codehilite"><pre><span></span><span class="o">##</span> <span class="n">Three</span>

<span class="nb">Text</span><span class="p">.</span>

<span class="n">Three</span> <span class="n">tree</span><span class="p">.</span> <span class="p">[</span><span class="n">Link</span> <span class="k">to</span> <span class="n">note</span><span class="p">](..</span><span class="o">/</span><span class="n">note</span><span class="p">.</span><span class="n">md</span><span class="p">)</span>

<span class="o">-</span> <span class="n">a</span>
<span class="o">-</span> <span class="n">b</span>
<span class="o">-</span> <span class="err">{</span><span class="o">%</span> <span class="n">include</span> <span class="ss">&quot;string.md&quot;</span> <span class="o">%</span><span class="err">}</span> 
</pre></div>
</span></span><!-- comment -->
<pre><code class="markdown">[Link to two](two.md &quot;Title 2&quot;)
</code></pre>
<p><!-- endcomment -->
</p></span><p>Check that simple <a href="inc_note.md">links</a> still resolve correctly after rendered include with markdown-style link.</p>
<p>With no qoutes:</p>
<span><h2>One</h2><p>The <strong>first</strong> one.</p><p>This is a <a href="includes/two.md" title="Title 2">Link to two</a> and this is is a <a href="includes/three.md">link to three</a>.</p><span><h2>Two</h2><p>Text.</p><p><strong>Two too.</strong></p><p>This is a <a href="includes/one.md">Link to one</a> and this is is a <a href="includes/three.md">link to three</a>.</p><span><div class="codehilite"><pre><span></span><span class="o">##</span> <span class="n">Three</span>

<span class="nb">Text</span><span class="p">.</span>

<span class="n">Three</span> <span class="n">tree</span><span class="p">.</span> <span class="p">[</span><span class="n">Link</span> <span class="k">to</span> <span class="n">note</span><span class="p">](..</span><span class="o">/</span><span class="n">note</span><span class="p">.</span><span class="n">md</span><span class="p">)</span>

<span class="o">-</span> <span class="n">a</span>
<span class="o">-</span> <span class="n">b</span>
<span class="o">-</span> <span class="err">{</span><span class="o">%</span> <span class="n">include</span> <span class="ss">&quot;string.md&quot;</span> <span class="o">%</span><span class="err">}</span> 
</pre></div>
</span></span><!-- comment -->
<pre><code class="markdown">[Link to two](two.md &quot;Title 2&quot;)
</code></pre>
<p><!-- endcomment -->
</p></span><p>Check that simple <a href="inc_note.md">links</a> still resolve correctly after rendered include with markdown-style link and no quotes.</p>
<p>Unicode title:</p>
<span><h2>One</h2><p>The <strong>first</strong> one.</p><p>This is a <a href="includes/two.md" title="Title 2">Link to two</a> and this is is a <a href="includes/three.md">link to three</a>.</p><span><h2>Two</h2><p>Text.</p><p><strong>Two too.</strong></p><p>This is a <a href="includes/one.md">Link to one</a> and this is is a <a href="includes/three.md">link to three</a>.</p><span><div class="codehilite"><pre><span></span><span class="o">##</span> <span class="n">Three</span>

<span class="nb">Text</span><span class="p">.</span>

<span class="n">Three</span> <span class="n">tree</span><span class="p">.</span> <span class="p">[</span><span class="n">Link</span> <span class="k">to</span> <span class="n">note</span><span class="p">](..</span><span class="o">/</span><span class="n">note</span><span class="p">.</span><span class="n">md</span><span class="p">)</span>

<span class="o">-</span> <span class="n">a</span>
<span class="o">-</span> <span class="n">b</span>
<span class="o">-</span> <span class="err">{</span><span class="o">%</span> <span class="n">include</span> <span class="ss">&quot;string.md&quot;</span> <span class="o">%</span><span class="err">}</span> 
</pre></div>
</span></span><!-- comment -->
<pre><code class="markdown">[Link to two](two.md &quot;Title 2&quot;)
</code></pre>
<p><!-- endcomment -->
</p></span><p>Check that simple (though fake) <img alt="image links" src="inc_note.md" /> still resolve correctly after all.</p>