Home

Awesome

markdown-mod

THIS PLUGIN IS DEPRECATED SINCE HOME ASSISTANT VERSION 0.99

ALL FUNCTIONALIY IS NOW BUILT INTO HOME ASSISTANT BY DEFAULT

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>ExampleResult
Entity idlight.bed_lightThe current state of the entity
Statelight.bed_light.stateSame as above
Attributelight.bed_light.attributes.friendly_nameThe 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
Conditionalif(<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 ]]

markdown-mod

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.

markdown icon


<a href="https://www.buymeacoffee.com/uqD6KHCdJ" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/white_img.png" alt="Buy Me A Coffee" style="height: auto !important;width: auto !important;" ></a>