Skip to main content

Tidal Blog Info

Purpose

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 Tidal!

Templates

To make submitting posts easier, there are a set if templates. 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.

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!

Markdown

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

tip

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

caution

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.

Another "details" segment, with code:

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