Kirby Help

finding and changing the Title in header.php
title actually resides in a simple .txt file
located in /content/site.txt

The $site object contains all important information about your site in general and all data stored in /content/site.txt

Markdown Syntax

for a full list of Markdown Syntax visit Daring Fireball

all quoted text comes from that website

emphasis:
*bold* thus: bold
_bold_ and: bold

comments: use HTML comment syntax, ie: <!-- comment here -->

"Unordered (bulleted) lists use asterisks, pluses, and hyphens (*, +, and -) as list markers. These three markers are interchangable:"

* Dogs.
* Cats.
* Sandwiches.

thus:

"Ordered (numbered) lists use regular numbers, followed by periods, as list markers:"

  1. Red
  2. Green
  3. Blue

Output (this goes for unordered lists too):

<ol>
<li>Red</li>
<li>Green</li>
<li>Blue</li>
</ol>

Links:

"Markdown supports two styles for creating links: inline and reference. With both styles, you use square brackets to delimit the text you want to turn into a link."

"Inline-style links use parentheses immediately after the link text. For example:"

This is an [example link](http://example.com/).

Output:

<p>This is an <a href="http://example.com/">
example link</a>.</p>"

"Optionally, inline-style links may include a title attribute in the parentheses:"

This is an [example link](http://example.com/ "With a Title").

This is an example link - and when you hover your mouse over it, you will see the title.

"Reference-style links allow you to refer to your links by names, which you define elsewhere in your document:"

I get better results using [DuckDuckGo][1] than from [Google][2] or [Yahoo][3].

[1]: https://duckduckgo.com/ "DuckDuckGo"
[2]: https://google.com/ "Google Search"
[3]: https://yahoo.com/ "Yahoo Search"

renders thus:

I get better results using DuckDuckGo than from Google or Yahoo.

Images

placing images is really easy;
simply type the following (without the spaces):

( image: tepid.jpg caption: relevant caption text class: uniquename )

( image: tepid.jpg caption: relevant caption text class: uniquename )

place the image/s in the same folder as the relevant .txt file.

horizontal rule - four underscores in a row. there are others but this is sufficient.


Code:

To indicate a span of code, wrap it with backtick quotes (`). Unlike a pre-formatted code block, a code span indicates code within a normal paragraph. For example:

Use the printf() function.

will produce:

<p>Use the <code>printf()</code> function.</p>

Automatic Links

Markdown supports a shortcut style for creating “automatic” links for URLs and email addresses: simply surround the URL or email address with angle brackets. What this means is that if you want to show the actual text of a URL or email address, and also have it be a clickable link, you can do this:

http://example.com/

Markdown will turn this into:

<a href="http://example.com/">http://example.com/</a>

Automatic links for email addresses work similarly, except that Markdown will also perform a bit of randomized decimal and hex entity-encoding to help obscure your address from address-harvesting spambots. For example, Markdown will turn this:

address@example.com

into something like this:

<ahref="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65; &#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111; &#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61; &#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

which will render in a browser as a clickable link to “address@example.com”.

(This sort of entity-encoding trick will indeed fool many, if not most, address-harvesting bots, but it definitely won’t fool all of them. It’s better than nothing, but an address published in this way will probably eventually start receiving spam.)