# Creating Reports In-App

There are 2 ways to create knowledge in the browser:

## 1. Upload Existing Files & Folders

You can publish existing content by creating new files & folders on the UI, and upload from your local machine. These can be any format that Kyso currently works with:

* Jupyter Notebooks
* Markdown
* HTML
* Images
* PDFs
* PowerPoints
* Video files (will render embedded in a markdown document)

Simply navigate to "**Post a report"** at the top of your Organization/Channel dashboard and select **"Upload report files"**.&#x20;

{% hint style="info" %}
For file types that are relevant to your research post that we might not support **yet**, they will still be hosted and available to download by other users when uploaded.
{% endhint %}

## 2. Write Reports from Scratch

This is where you can create reports from scratch in Kyso's markdown editor just as you would on Notion, Google Docs or any other general knowledge wiki.

Kyso has it's very own built-in markdown editor. On the Organisation or Channel dashboard, simply navigate to "**Post a report"** at the top and select **"Create new report in the UI".**

This will take you to `https://kyso.io/<organisation-name>/create-report/`.

<figure><img src="/files/Wfd2v3PmqIpsQGQGd72m" alt=""><figcaption><p>Create a Report</p></figcaption></figure>

Here you can write up a report from scratch, embed images and code snippets, create new files & folders on the UI, and upload from your local machine. You can even build cool engineering process diagrams like [Mermaid](https://mermaid.js.org/) in the editor!

### Images&#x20;

Simply click on the image icon at the top when you want to include an image. You simply need to supply the URL of the image you're linking to. If you upload an image to the report file browser and want to embed that image in the document, the notation is `./image_name.png`, where `.` is the directory of the main markdown file you are editing.

We don't support image links with spaces in the name. So if you link an image in the report, do it like this:

```
![alt text](image_name.png)
```

and don't do it like this:

```
![alt text](image name.png)
```

### Limitations

{% hint style="info" %}
Note that there is a 5MB limit on the **combined** file size of the report created in the Edit page. This is because these files are stored in local storage during the editing process. If your project is much larger, it is advised to document everything externally & to instead use the upload page to create this report on Kyso, which has a much larger size limit.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.kyso.io/posting-to-kyso/creating-reports-on-kyso.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
