feat: add priority to sign configuration

## Details

Request: #601

Allows user to define a custom priority to use for signs to decide which
ones should be shown, defaults to nil.

Author: MeanderingProgrammer

README.md

@@ -847,6 +847,8 @@ require('render-markdown').setup({
     sign = {
         -- Turn on / off sign rendering.
         enabled = true,
+        -- Priority to assign to sign.
+        priority = nil,
         -- Applies to background of sign text.
         highlight = 'RenderMarkdownSign',
     },
@@ -1642,6 +1644,8 @@ require('render-markdown').setup({
     sign = {
         -- Turn on / off sign rendering.
         enabled = true,
+        -- Priority to assign to sign.
+        priority = nil,
         -- Applies to background of sign text.
         highlight = 'RenderMarkdownSign',
     },

doc/render-markdown.txt

@@ -1,4 +1,4 @@
-*render-markdown.txt*       For NVIM v0.11.6      Last change: 2026 January 28
+*render-markdown.txt*       For NVIM v0.11.6      Last change: 2026 January 29
 
 ==============================================================================
 Table of Contents                          *render-markdown-table-of-contents*
@@ -913,6 +913,8 @@ Default Configuration ~
         sign = {
             -- Turn on / off sign rendering.
             enabled = true,
+            -- Priority to assign to sign.
+            priority = nil,
             -- Applies to background of sign text.
             highlight = 'RenderMarkdownSign',
         },
@@ -1686,6 +1688,8 @@ Sign Configuration ~
         sign = {
             -- Turn on / off sign rendering.
             enabled = true,
+            -- Priority to assign to sign.
+            priority = nil,
             -- Applies to background of sign text.
             highlight = 'RenderMarkdownSign',
         },

lua/render-markdown/health.lua

@@ -6,7 +6,7 @@ local state = require('render-markdown.state')
 local M = {}
 
 ---@private
-M.version = '8.11.3'
+M.version = '8.11.4'
 
 function M.check()
     M.start('versions')

lua/render-markdown/render/base.lua

@@ -63,6 +63,7 @@ function Base:sign(config, enabled, text, highlight)
         sign_highlight = colors.combine(highlight, sign_highlight)
     end
     self.marks:start(config, 'sign', self.node, {
+        priority = sign.priority,
         sign_text = text,
         sign_hl_group = sign_highlight,
     })

lua/render-markdown/settings.lua

@@ -1750,12 +1750,15 @@ M.sign = {}
 
 ---@class (exact) render.md.sign.Config
 ---@field enabled boolean
+---@field priority? integer
 ---@field highlight string
 
 ---@type render.md.sign.Config
 M.sign.default = {
     -- Turn on / off sign rendering.
     enabled = true,
+    -- Priority to assign to sign.
+    priority = nil,
     -- Applies to background of sign text.
     highlight = 'RenderMarkdownSign',
 }
@@ -1766,6 +1769,7 @@ function M.sign.schema()
     return {
         record = {
             enabled = { type = 'boolean' },
+            priority = { optional = true, type = 'number' },
             highlight = { type = 'string' },
         },
     }

lua/render-markdown/types.lua

@@ -293,6 +293,7 @@
 
 ---@class (exact) render.md.sign.UserConfig
 ---@field enabled? boolean
+---@field priority? integer
 ---@field highlight? string
 
 ---@alias render.md.window.UserConfigs table<string, render.md.window.UserConfig>