# Is there a complete Markdown Template documentation somewhere?

**URL:** <https://community.fibery.io/t/is-there-a-complete-markdown-template-documentation-somewhere/4654>\
**Category:** Get Help\
**Created:** [June 21, 2023, 4:26am UTC](https://community.fibery.io/t/is-there-a-complete-markdown-template-documentation-somewhere/4654 "2023-06-21T04:26:21Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![njyo](https://sea2.discourse-cdn.com/flex020/user_avatar/community.fibery.io/njyo/32/923_2.png) [@njyo](https://community.fibery.io/u/njyo)\
**Post date:** [June 21, 2023, 4:26am UTC](https://community.fibery.io/t/is-there-a-complete-markdown-template-documentation-somewhere/4654/1 "2023-06-21T04:26:21Z")

</div>

Hi,

The [Markdown Template documentation in the Fibery API](https://api.fibery.io/#markdown-template) is rather bare-bones…

It has:

1. Markdown basics (which probably would better just link to a [guide like this](https://www.markdownguide.org))
2. Shortcuts for entity fields and lists, etc. (i.e. templating)
3. How to use JavaScript

It’s overall rather dense and because the fields supporting Markdown do not have the level of inline support like formulae, it’s a lot of trial and error.

What I would like the docs to contain as well:

1. List of default entity fields e.g. Entity.Name, Entity.Icon
2. How to format the fields e.g. how to print Entity.Creation Date as YYYY-MM-DD or rounding a number, etc.
3. How to access entity field properties e.g. Entity.Status.Label or Entity.Type.Icon as emoji
4. How to traverse relationships
5. How to insert conditionals with or without JS e.g. if entity.field is empty…

As said, it’s possible to figure out with trial and error, but a more complete documentation (and linking to it from your Automations) would be MUCH appreciated.

Thanks!

---

<div class="post-metadata">

**Author:** ![Chr1sG](https://sea2.discourse-cdn.com/flex020/user_avatar/community.fibery.io/chr1sg/32/3941_2.png) [@Chr1sG](https://community.fibery.io/u/Chr1sG)\
**Post date:** [June 21, 2023, 6:01am UTC](https://community.fibery.io/t/is-there-a-complete-markdown-template-documentation-somewhere/4654/2 "2023-06-21T06:01:10Z")

</div>

It doesn’t address all your points, but the main Fibery user guide includes [this page](https://the.fibery.io/@public/User_Guide/Guide/Markdown-Templates-53)

---

<div class="post-metadata">

**Author:** ![njyo](https://sea2.discourse-cdn.com/flex020/user_avatar/community.fibery.io/njyo/32/923_2.png) [@njyo](https://community.fibery.io/u/njyo)\
**Post date:** [June 21, 2023, 7:11am UTC](https://community.fibery.io/t/is-there-a-complete-markdown-template-documentation-somewhere/4654/3 "2023-06-21T07:11:28Z")

</div>

Thanks, @Chr1sG. Ah yeah, I remember coming past [your guide page](https://the.fibery.io/@public/User_Guide/Guide/Markdown-Templates-53) as well, which frankly didn’t help with confusion as there are two different documents and it’s unclear what is for what and how they relate (and they are not linked).

I guess the questions not answered are:  
#2 How to format fields  
#3 How to insert conditionals

I guess the other thing I just find very confusing is the different types of syntax used in Markdown vs. Formulae especially with entity property names: Formulae use `Entity.[Split Name]` while Markdown uses `{{Entity.Split Name}}` which just _feels_ wrong. 😬

---

<div class="post-metadata">

**Author:** ![Chr1sG](https://sea2.discourse-cdn.com/flex020/user_avatar/community.fibery.io/chr1sg/32/3941_2.png) [@Chr1sG](https://community.fibery.io/u/Chr1sG)\
**Post date:** [June 21, 2023, 11:42am UTC](https://community.fibery.io/t/is-there-a-complete-markdown-template-documentation-somewhere/4654/4 "2023-06-21T11:42:42Z")

</div>

> [@njyo](#):
>
> there are two different documents and it’s unclear what is for what and how they relate

Yeah, we can do better with our educational materials.

For #2, the user guide has a basic example of how to do formatting of dates in JS

 ![image](https://us1.discourse-cdn.com/flex020/uploads/fibery/original/2X/4/4e64f191d36e2ecfa6c6fca954749c754b79ef2e.png)

Formatting of numbers isn’t covered, but that’s more of a JS question (of which there are potentially too many to include answers to in the user guide).  
Maybe [this](https://www.tutorialstonight.com/javascript-number-format) helps?

For #3, it is again a JS issue, so you would need to use something like the following (E&OE 😉 ):

```auto
<%
    const fibery = context.getService('fibery');
    const entityPlus = await fibery.getEntityById(Entity.Type, Entity.Id, ['Owner','Effort']);
    if (entityPlus['Owner']['Name'] == "Steve") {
%>
Effort required by Steve: <%= entityPlus['Effort'] %>
<%
    };
%>

```

---

<div class="post-metadata">

**Author:** ![njyo](https://sea2.discourse-cdn.com/flex020/user_avatar/community.fibery.io/njyo/32/923_2.png) [@njyo](https://community.fibery.io/u/njyo)\
**Post date:** [June 22, 2023, 10:51am UTC](https://community.fibery.io/t/is-there-a-complete-markdown-template-documentation-somewhere/4654/5 "2023-06-22T10:51:12Z")

</div>

Thanks, @Chr1sG, but sadly it seems like JS does not work in the Slack integration, so there I can only use the basic Markdown templates and hence no formatting:

Example Setup:

 ![2023-06-22 at 18.49](https://us1.discourse-cdn.com/flex020/uploads/fibery/original/2X/7/7b953cb5a8549c056b22772ab727213068e2c33e.png)

Results in:

 ![2023-06-22 at 18.50](https://us1.discourse-cdn.com/flex020/uploads/fibery/original/2X/e/ee0de68630fb99dff7e05dc95fc799544bd2174b.png)

I’d love to make that all a little more legible. 😉

Thanks!