Cards can be as simple as containing brief task descriptions or as extensive as complex design documents.
The card text editor supports the markdown syntax. Once you save the card, it will be rendered in a way that turns your text, lists and headers into nice looking documents. For a detailed overview of all the syntax rules for markdown, check the document above. A handy shortcut link is also shown on top of the text editor.
If you are unsure how something will look on the final card, you can use the preview mode to see how your formatting will look without having to save the card the first.
# heading level 1 ## heading level 2 ### heading level 3 etc - list element 1 - list element 2 - can be nested too 1. numbered list 2. second entry an [example link](https://example.com) inline formatting: _italics_, __bold__, ~~strike through~~, `code` > quote ``` code block ``` ___ horizontal rule
Check out this cheat sheet for more examples like embedding tables or images. Note that Codecks does not support using HTML within markdown.
If you want to split up a task into sub steps you may use checklists. The syntax for checklists looks like:
- [ ] a task for me - [ ] another task - [x] one more task which is already done -  works without space as well
Saving this card text will show a list of checklist items. You can use the mouse to check off the items directly on the card. You can manually create a checked-off checklist item by putting an ‘x’ between the square brackets as shown above. Whenever you mark a checklist item as done using the mouse, the text is automatically updated to stay in sync.
Similar to any other activity, changes to checklists are also visible in the history panel of each card.
Checklists are great for items that are managed on a single card. To create more powerful sub cards, please check the hero cards documentation.
$ will pop open a list of other recently touched cards. You may modify the content of the list by entering a couple more letters to narrow down the search card list. You can also search for multiple words by separating them with
_. Select the card you want to reference by using the mouse or by using the arrow keys and confirming with tab or enter. A color-coded link will be entered in the card text.
This is a great way to build multi-card documents in a wiki-style, allowing you to build your full GDD in Codecks. The link shows the title and status of the linked card. Hovering over the link will open a mini preview of the referenced card. If you change the title or status of referenced cards, the link will update its appearance automatically as well. Clicking the link opens the referenced card.
You may also reference another card by copy’n’pasting the URL of another card. It will automatically convert the link into a short-hand reference link. To get the URL of a card you can also just click on the dollar sign label shown on top of each opened card.
URLs of cards contain the title so that other people can already infer what the card is about when you paste it into an email or chat. It is good to know that those links remain valid even if the card content changes, so you don’t have to worry about breaking links by changing the card text.
These references also work inside of comments.
@ will open a list of your team members. You can narrow down the content list by entering some letters of the user name that you want to reference. Selecting an entry via mouse or keyboard will add a link to that user and notify them of the fact that they were mentioned on this card.
Mentioning a user within a card automatically leads to that user watching that card. This means they will receive notifications for important updates to the card.
Mentioning a user within a comment adds them to the conversation if they’re not already present.
If you want to focus on writing or reading a longer document, you can use the wide mode, which doubles the text area of a card by using the double-arrow icon next to an opened card.
: and a letter will open the emoji selector allowing you to choose an emoji from the list. As you enter more letters the list will be filtered by emojis fitting to your search word.
You don’t have to remember the precise emoji name as we have categorized our emojis via keywords. For example entering
:hand will also offer you the
:pinchedfingers: emoji although technically the emoji name does not contain the word hand. 🦸
There are two ways to add an image to your card or comment:
!. This will open a list of attachments to insert. Use your mouse or keyboard to select the image.
Once inserted, these images can be viewed with our image viewer.
# will open a list of available tags. Typing more characters will filter the list. You can always “invent” new tags by continuing to type without confirming any suggested tags. For more information on how to work with tags and the difference between project tags and personal tags, refer to the Tags section.