Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

This node operation allows rendering Markdown text into HTML using a Gitea API endpoint. It is useful when you want to convert raw Markdown content into rendered HTML for display purposes, such as previewing issue descriptions, comments, wiki pages, or files hosted in a Gitea repository. Typical use cases include generating formatted content previews in automation workflows or integrating rendered Markdown into other systems.

Properties

Name Meaning
Context URL path used to resolve relative links within the Markdown content. Expected format: /subpath/{user}/{repo}/src/{branch, commit, tag}/{identifier/path}/{file/dir}. This helps render issue, media, and file links correctly.
Mode Specifies the rendering mode. Possible values are: markdown, comment, wiki, file. This determines how the Markdown is interpreted and rendered.
Text The raw Markdown text that you want to render into HTML.
Wiki Boolean flag indicating if the content is a wiki page (deprecated). If true, it uses the wiki mode instead.

Output

The node outputs JSON data containing the rendered HTML version of the provided Markdown text. The exact structure depends on the Gitea API response but typically includes an HTML string representing the rendered content. There is no binary output.

Dependencies

  • Requires connection to a Gitea instance via its API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for the Gitea API must be set in the node credentials.

Troubleshooting

  • Invalid Context Format: Ensure the Context property follows the expected URL path format; otherwise, relative links may not render correctly.
  • Authentication Errors: Verify that the API key credential is valid and has sufficient permissions to access the rendering endpoint.
  • Unsupported Mode: Using an unsupported value for Mode may cause errors or unexpected rendering results. Use one of the documented modes.
  • Deprecated Wiki Property: Avoid relying on the deprecated Wiki boolean; prefer setting Mode explicitly to wiki if needed.

Links and References

Discussion