markdown-mod

Makes the built-in markdown card better.

For installation instructions see this guide.

Install markdown-mod.js as a module.

Usage

This is not a new card. Instead it changes the way the built-in markdown card works.

Specifically, it adds the ability to have the content of the card change dynamically with your Home Assistant state.

It also allows you to put icons in the markdown using e.g. <ha-icon icon="mdi:home-assistant"></ha-icon>

For dynamic content, the magic begins with the template [[ <template> ]].

See This article for further details on templates.

Any time [[ <template> ]] is found in the content: of any markdown card, it will be replaced with something else depending on what <template> is.

It can be:

<template>	Example	Result
Entity id	light.bed_light	The current state of the entity
State	light.bed_light.state	Same as above
Attribute	light.bed_light.attributes.friendly_name	The current value of the specified entitys specified attribute
Username	{user}	The username of the currently logged in user
Device ID	{browser}	The ID of the currently used device-browser combination
Hash	{hash}	The hash part of the current URL
Conditional	if(<condition>, <then>, <else>)	The template in <then> if <condition> is true. Otherwise <else>.

In the conditional case, <then> and <else> can be any of the above templates (including Conditional).

<condition> is of the form <template> <comparison> <template> where <comparison> is one of ==, !=, <, >, <= or >=.

Example

type: markdown
title: Default markdown card
content: |
  # Title
  ## Subtitle
  - list
  - items

  [A link](https://google.com)

  [[ light.bed_light.state ]] [[ light.bed_light ]] [[ light.bed_light.attributes.friendly_name ]]
  [[ sensor.mysensor.state ]]%

  Username: [[ {user} ]] Browser ID: [[ {browser} ]]
  Current URL hash: [[ {hash} ]]

  [[ if(light.bed_light == "on", "The lights are on", "It's dark") ]]
  [[ if(input_number.x_pos <= 30, "small", if(input_number.x_pos <= 70, "Medium", "LARGE")) ]]
  [[ sensor.outside_temperature.last_updated ]]

type: markdown
title: ha-icon
content: |
  This is a markdown card! With mdi icons!
  <ha-icon icon="mdi:home-assistant"></ha-icon>

  Right in the <ha-icon icon="mdi:format-align-middle"></ha-icon> of the <ha-icon icon="mdi:text"></ha-icon> too.

---