> For the complete documentation index, see [llms.txt](https://docs.kyso.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kyso.io/kysos-renderer/markdown.md).

# Markdown

Creating markdown reports on Kyso

## Pushing Existing Files

Users can upload their markdown (.md) files to Kyso directly on the UI:

{% content-ref url="/pages/-LjzhPN6Oo\_n\_4fh9D3f" %}
[Creating Reports In-App](/posting-to-kyso/creating-reports-on-kyso.md)
{% endcontent-ref %}

or with the Kyso CLI tool:

{% content-ref url="/pages/LEia9hOEUZaGfGYFxZbc" %}
[Publishing & Downloading](/posting-to-kyso/kysos-command-line-tool/publishing-and-downloading.md)
{% endcontent-ref %}

## Writing Reports from Scratch

Kyso also 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="https://4003540104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjzfPqQ1fXmC4OMXwiD%2Fuploads%2FyK9t54cQXgowHHdliVw8%2Fcreate-report.png?alt=media&amp;token=8899f0aa-a022-4b04-9e38-6213103c10e5" alt=""><figcaption><p>Create a Report</p></figcaption></figure>

Here you can write up a report from scratch, 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!