diff --git a/doc/helper_doc_template.md b/doc/helper_doc_template.md
index 1ae6095a3..1b9fa873d 100644
--- a/doc/helper_doc_template.md
+++ b/doc/helper_doc_template.md
@@ -12,45 +12,46 @@ Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/{{
{% for category, helpers in data.helpers %}
### {{ category.upper() }}
{% for h in helpers %}
-**{{ h.name }}**
+**{{ h.name }}**
[details summary="{{ h.brief }}" class="helper-card-subtitle text-muted"]
**Usage**: `{{ h.usage }}`
- {% if h.args %}
+{%- if h.args %}
-**Arguments**:
- {% for infos in h.args %}
- {% if infos|length == 2 %}
+**Arguments**:
+ {%- for infos in h.args %}
+ {%- if infos|length == 2 %}
- `{{ infos[0] }}`: {{ infos[1] }}
- {% else %}
+ {%- else %}
- `{{ infos[0] }}`, `{{ infos[1] }}`: {{ infos[2] }}
- {% endif %}
- {% endfor %}
- {% endif %}
- {% if h.ret %}
+ {%- endif %}
+ {%- endfor %}
+{%- endif %}
+{%- if h.ret %}
**Returns**: {{ h.ret }}
- {% endif %}
- {% if "example" in h.keys() %}
+{%- endif %}
+{%- if "example" in h.keys() %}
+
**Example**: `{{ h.example }}`
- {% endif %}
- {% if "examples" in h.keys() %}
+{%- endif %}
+{%- if "examples" in h.keys() %}
-**Examples**:
- {% for example in h.examples %}
- {% if not example.strip().startswith("# ") %}
+**Examples**:
+ {% for example in h.examples %}
+ {% if not example.strip().startswith("# ") %}
- `{{ example }}`
- {% else %}
+ {% else %}
- `{{ example.strip("# ") }}`
- {% endif %}
- {% endfor %}
- {% endif %}
- {% if h.details %}
+ {% endif %}
+ {% endfor %}
+{%- endif %}
+{%- if h.details %}
-**Details**:
-{{ h.details.replace('\n', '').replace('_', '\_') }}
- {% endif %}
+**Details**:
+{{ h.details }}
+{%- endif %}
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/{{ current_commit }}/data/helpers.d/{{ category }}#L{{ h.line + 1 }})
[/details]