Skip to main content

Tidal Blog Info


The Tidal Cycles blog is intended to be by -- for -- about the Tidal community. Anyone engaged with Tidal Cycles is encouraged to submit a blog post. Topics can be about Tidal practices, music made with Tidal, live coding, event coverage, new developments & releases, community, etc. Topics can also be broader -- anything that would be of interest to this community, and it doesn't have to be limited to just about Tidal!


To make participation and submitting posts easier, there are a set if templates. These produce a set of patterned blog posts. Each template includes a suggested set of content sections, but consider this just a starting point. The most important thing is to provide content that reflects your unique perspective.

Templates are maintained in GitHub in the tidalcycles/tidal-doc repo / templates branch.

  • Tidal Blog Profile Intended to highlight your livecoding practices, music, and use of tidal. Contains a set of questions to respond to.a

  • Tidal music Use this to describe a music project such as a new album or music release, a review of a music project, Algorave or concert, or discussion of music made with Tidal or other live coding program.a

  • Blog Topic Open topic. Use this for a more free-form approach. One option is to present your own approach to Tidal and live coding (see Working with Samples the Heavy Lifting way). Other topics could be discussion of a new release and the coding behind it, or discussion of other environments like Strudel, Vortex, Sardine, etc.

  • Playlist Use this to create a new playlist. See the Tidal Eclectic Playlist for an example.

We encourage posts to include:

  • code sections with Tidal examples
  • links into the Tidal user documentation
  • links to recordings, YouTube, Bandcamp, SoundCloud, etc.

Submission Instructions

Detailed posting instructions are included in the template files. Options:

  • Submit via GitHub pull request
  • Work with a blog editor and send your content via Discord DM or email.

Do what works for you!


Submitting you content in markdown format is preferred, but it is not required. If you aren't familiar with markdown, no problem. Write your content and we'll take care of the rest.

Docusaurus, MDX and markdown enhancements

The Tidal blog is rendered in Docusaurus which uses MDX as the parsing engine. It supports more layout features including React components. To see the full list of options, check out the Docusaurus Markdown Features page. Here are some examples. There are many more!

Admonitions - triple colon syntax


This is a tip and is called by the triple colon syntax :::tip. You can also customize admonitions.


When using admonitions - be sure to add empty lines before and after your text lines.

Details element

Toggle to see more
This is the detail revealed. This is useful for a long code block, allowing users flexibility in how they read through your post.

Toggle for code block
``` h1 $ s "sound" h2 h3 ```

Toggle for code block - (no div)
``` h1 $ s "sound" h2 h3 ```