# Markdown

## Pushing Existing Files

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

{% content-ref url="../posting-to-kyso/creating-reports-on-kyso" %}
[creating-reports-on-kyso](https://docs.kyso.io/posting-to-kyso/creating-reports-on-kyso)
{% endcontent-ref %}

or with the Kyso CLI tool:

{% content-ref url="../posting-to-kyso/kysos-command-line-tool/publishing-and-downloading" %}
[publishing-and-downloading](https://docs.kyso.io/posting-to-kyso/kysos-command-line-tool/publishing-and-downloading)
{% 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&#x26;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!