Skip to content

Frequently Asked Questions

This page collects Frequently Asked Questions of the community.
If you have any questions that aren't answered here, feel free to ask on our community forums or in out Matrix chat.

Why did you switch from MathJax to KaTeX?

The new react frontend, that was introduced with HedgeDoc 2.0 switched from MathJax 2 to KaTeX, because:

Why are code-blocks with 'sequence' as language deprecated?

Starting with HedgeDoc 2.0, mermaid is used for rendering sequence-diagrams. The syntax doesn't change. To remove the deprecation warning, simply change the codeblock-"language" from sequence to mermaid and insert a single line with sequenceDiagram just before your diagram content.


Alice->>John: Hello John, how are you?
John-->>Alice: Great!


Alice->>John: Hello John, how are you?
John-->>Alice: Great!

Why do tags in headings don't work anymore?

Starting with HedgeDoc 2.0, we don't support tag headings in the note anymore.

#### tags: `tag1`, `tag2`

Instead, please use the frontmatter metadata to specify tags.

Why is the comma separated definition of tags in the YAML-metadata deprecated?

YAML already has a definition for lists. Therefore, we don't see any reason to maintain another way to define a list.


tags: tag1, tag2


    - tag1
    - tag2


tags: ['tag1', 'tag2']

Why should I want to run my renderer on a different (sub-)domain?

If the renderer is provided by another domain, it's way harder to manipulate HedgeDoc or steal credentials from the rendered note content, because renderer and editor are more isolated. This increases the security of the software and greatly mitigates XSS attacks. However, you can run HedgeDoc without this extra security, but we recommend using it if possible.


When you want to use a separate domain for HD_RENDERER_BASE_URL, your reverse proxy config needs to be adjusted to direct requests for this domain to the frontend.

Why are forkawesome icons deprecated?

As forkawesome icons are not really well maintained, we decided to replace them with bootstrap icons. To keep the compatibility with HedgeDoc 1 notes we still import them, but will likely remove those icons at some point. So your best take of action is replacing these icons with bootstrap icons.