Markdown and Text cells
Hex offers two ways of writing text in your project: markdown and text cells.
#
Markdown cellsMarkdown cells allow you to easily create richly-formatted text.
Hex uses the CommonMark markdown renderer - if you need help getting started with markdown we recommend checking out their reference and tutorial.
#
Dynamic markdownYou can also insert Python variables directly into Markdown cells. Type your text as usual but in place of hard-coding the value you want, wrap the variable name in {{ }}
braces to dynamically update your Markdown text. See the screenshot below for an example.
#
Text cellsText cells allow you to write text in a WYSIWYG (what you see is what you get) editor with rich formatting, variable references and user mentions all without needing to use Markdown syntax!
Text cells support all of the basic text stylings (headings, lists, font styling, etc.) which can all be done with the click of a button in the formatting options.
#
MentionsYou can ping other members of your workspace by mentioning them in a Text cell. When mentioning a user, they will receive a notification by email or slack.
#
Variable substitutionText cells support variable substitution using the usual double curly braces, {{}}
, of Jinja syntax. In order to render values, you'll need to run the cell.
tip
Complex logic such as if statements and for loops are not yet supported.
#
HeadingsTo add a heading, select the text that you want to format and right click. The options menu will appear over the selected text from which you can choose your heading size.
#
ListsTo create an ordered or unordered list, select the list formatting option on the far right of the menu.
#
LinksTo add links to a Text cell, select the part of your text where the link will go and select the link formatting option. Press enter once the link has been pasted to commit your changes. You can also add links by pasting the link over the text you wish to format
#
Code formattingYou can highlight variables within a Text cell using the code formatting option.
tip
Code blocks are not yet supported in Text cells.
#
QuotesYou can add a quote to a Text cell by selecting the blockquote option in the formatting menu.
#
Drag and drop imagesYou can render images in Markdown and Text cells by dragging a file from your computer and dropping it in the cell! The image is uploaded as a file and can be referenced again in a downstream cell.