> For the complete documentation index, see [llms.txt](https://moontale.hmilne.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://moontale.hmilne.cc/concepts.md).

# Concepts

{% hint style="info" %}
This guide assumes some familiarity with Lua! Consider skimming chapters 1 through 5 of [Programming in Lua](https://www.lua.org/pil/1.html) if you're new to the language.
{% endhint %}

## Markdown

Moontale's main language is a variant of [Markdown ](https://commonmark.org/help/)that allows mixing Lua code with regular text. We'll call this language 'Moontale-flavoured-Markdown' -  MFM for short. The [Syntax ](/syntax.md)section has more details on the differences.

## Stories and Passages

In Twine, a Story is a collection of Passages that are (typically) joined together by Links.

A Passage is simply a block of code that gets transformed into text and formatting that the end user can see. The type of code that a Passage contains depends on the 'story format' selected - in the case of Moontale, that would be MFM.

A Story has a 'Start Passage' which the editor can change. When a story is 'run' or 'played', the host will display this passage as its entry point into the story.

## Render functions

The content of a passage (as well as any inner Content Blocks) is realised as a 'render function' - a function that, when called with no arguments, writes its content to the screen. Render functions, just like normal Lua functions, can be passed around, saved and copied like any other value.

```
The following definitions are equivalent:
1. $Name.foo[Some text **with markup**]
2. {$ function foo() Text('Some text ') Style.em('with markup') end $}
```

## Overriding

Many of Moontale's standard functions can be overridden by simply replacing their definitions. This is especially useful because Moontale's markdown syntax will refer to Lua expressions instead of a hard-coded style. For example:

```lua
function Link()
    Show('Instead of a link, have some text!')
end
```

If a function is defined in a table, like `Style`, you can override it by overwriting it:

```lua
Style.em = Color.blue -- *Text* will be blue instead of italicised
Style.em = nil -- Revert to the default behaviour
```

You can use the 'base' definitions as well:

```lua
Style.em = Combine(Style.em, Color.blue) -- *Text* will be blue as well as italicised
```

For 'free' functions, if you want to access the 'base' definition you'll need to save it first:

```lua
local _link = Link
function Link(target)
    -- Make all links red (while keeping their normal behaviour)
    return Combine(Color.red, _link(target)
end
```

🚧 When defining overrides, you should put them in a `startup`-tagged passage if they're common to your story. If they're specific to a passage, you should use the `With` changer; if you put them in a code block, the overrides will be permanent!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://moontale.hmilne.cc/concepts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.