Documentation

Datahub Cloud is your stupidly simple and fast tool for turning your data stories or datasets on GitHub into a published, shareable site. It converts raw data and Markdown files into beautifully presented, interactive sites.

Documentation

Note

The current version of Datahub Cloud runs only off Github.

How to deploy your first site within seconds

The quickest way to start publishing with Datahub Cloud is to publish our template and customize it to fit your needs. You can do that in 5 simple steps:

Go to template and click "Use this template" at the top right to create a new repository
Go to the app and create a new site by selecting the repository you just created (leave the "Root Dir" field empty)
Done, it is now published! Just hit the green "Visit" button at the top right to see what it looks like.

What to do after you publish your first site

After publishing our template and getting a feel for how it works, you have several options to customize it:

Take the template to the next level

Note

The template works best for datasets. If you don't have any data files, we suggest starting from scratch (go to Start from scratch)

Customize your site with CSS and HTML

Add visuals and data-rich components

Add sidebar navigation

Start from the scratch

Or if that's easier, you can start from scratch or from an existing repo in Github.

If you haven't worked with Github or your project does not live there, go ahead and create a new repository in Github. Create a README.md file, add some intro to it and publish it with Datahub Cloud.

Create a dataset from scratch

You can also publish an existing repository of your own and see what it looks like when published with Datahub Cloud. For any issues or errors, please open an issue here https://github.com/datopian/datahub/issues

Publish your Obsidian vault

You can also publish your Obsidian notes and create your handbook with Datahub Cloud. Eg. see this beautiful example https://datahub.io/@davidgasquez/handbook.

How to publish my Obsidian vault

What syntax is supported

Datahub Cloud supports CommonMark and GitHub Flavored Markdown, but also many Obsidian-specific syntax elements, like Wiki links or footnotes[^1].

See supported markdown syntax

Need help?

For any questions or suggestions for improvement please ping us on discord