feat: wrap nvim_buf_set_extmark in pcall use notify_once if it errors

## Details

Related to issues like
#382

We use a version check like `vim.fn.has('nvim-0.11') == 1` before adding
any `extmarks` that use version specific options like `conceal_lines`.
By doing this we avoid ever getting to the API call that adds the marks
and can add fallback behavior for certain decorations like code borders.

However this version check has to make the assumption that the user has
all the features of the released version, which should be safe for most
people. However anyone using a dev version could have built it at a time
where the version check passes but before that feature was introduced.

This should be somewhat rare as it relies on someone having a dev build
and not upgrading when a release occurs.

In the event of an error we use `vim.notify_once` to inform the user
that they should update their build or switch to the released version
while not spamming errors at them.

Minor other changes:

- use `vim.o` to get options instead of `nvim_get_option_value`
- update `colorcolumn` suggestions to use option value

Author: MeanderingProgrammer

README.md

@@ -766,15 +766,15 @@ require('render-markdown').setup({
         -- @see :h 'conceallevel'
         conceallevel = {
             -- Used when not being rendered, get user setting.
-            default = vim.api.nvim_get_option_value('conceallevel', {}),
+            default = vim.o.conceallevel,
             -- Used when being rendered, concealed text is completely hidden.
             rendered = 3,
         },
         -- @see :h 'concealcursor'
         concealcursor = {
             -- Used when not being rendered, get user setting.
-            default = vim.api.nvim_get_option_value('concealcursor', {}),
-            -- Used when being rendered, disable concealing text in all modes.
+            default = vim.o.concealcursor,
+            -- Used when being rendered, show concealed text in all modes.
             rendered = '',
         },
     },

doc/limitations.md

@@ -49,7 +49,7 @@ Below are a few things to try out to improve the aesthetic:
 ```lua
 require('render-markdown').setup({
     win_options = {
-        colorcolumn = { default = '80', rendered = '' },
+        colorcolumn = { default = vim.o.colorcolumn, rendered = '' },
     },
 })
 ```
@@ -58,13 +58,20 @@ require('render-markdown').setup({
 
 ```lua
 require('render-markdown').setup({
-    heading = { width = 'block', min_width = 80 },
-    code = { width = 'block', min_width = 80 },
+    heading = { width = 'block', min_width = tonumber(vim.o.colorcolumn) },
+    code = { width = 'block', min_width = tonumber(vim.o.colorcolumn) },
 })
 ```
 
 - Do not use `block` width, keep the default value of `full`
 
+```lua
+require('render-markdown').setup({
+    heading = { width = 'full' },
+    code = { width = 'full' },
+})
+```
+
 ## `latex` Formula Positioning
 
 [ISSUE #6](https://github.com/MeanderingProgrammer/render-markdown.nvim/issues/6)

doc/render-markdown.txt

@@ -1,4 +1,4 @@
-*render-markdown.txt*           For 0.11.0          Last change: 2025 March 31
+*render-markdown.txt*           For 0.11.0          Last change: 2025 April 01
 
 ==============================================================================
 Table of Contents                          *render-markdown-table-of-contents*
@@ -831,15 +831,15 @@ Default Configuration ~
             -- @see :h 'conceallevel'
             conceallevel = {
                 -- Used when not being rendered, get user setting.
-                default = vim.api.nvim_get_option_value('conceallevel', {}),
+                default = vim.o.conceallevel,
                 -- Used when being rendered, concealed text is completely hidden.
                 rendered = 3,
             },
             -- @see :h 'concealcursor'
             concealcursor = {
                 -- Used when not being rendered, get user setting.
-                default = vim.api.nvim_get_option_value('concealcursor', {}),
-                -- Used when being rendered, disable concealing text in all modes.
+                default = vim.o.concealcursor,
+                -- Used when being rendered, show concealed text in all modes.
                 rendered = '',
             },
         },

doc/troubleshooting.md

@@ -58,7 +58,7 @@ Create a new `markdown` file locally with the following content:
 
 Run `:InspectTree` which should output the following:
 
-```text
+```query
 (document ; [0, 0] - [8, 0]
   (section ; [0, 0] - [8, 0]
     (atx_heading ; [0, 0] - [1, 0]

lua/render-markdown/core/extmark.lua

@@ -31,20 +31,33 @@ end
 ---@param ns integer
 ---@param buf integer
 function Extmark:show(ns, buf)
-    if self.id == nil then
-        local mark = self.mark
-        mark.opts.strict = false
-        self.id = vim.api.nvim_buf_set_extmark(buf, ns, mark.start_row, mark.start_col, mark.opts)
+    if self.id ~= nil then
+        return
+    end
+    local mark = self.mark
+    mark.opts.strict = false
+    local ok, id = pcall(vim.api.nvim_buf_set_extmark, buf, ns, mark.start_row, mark.start_col, mark.opts)
+    if ok then
+        self.id = id
+    else
+        local message = {
+            string.format('render-markdown.nvim set extmark error (%s)', id),
+            'you are running an old build of neovim that has now been released',
+            'your build does not have all the features that are in the release',
+            'update your build or switch to the release version',
+        }
+        vim.notify_once(table.concat(message, '\n'), vim.log.levels.ERROR)
     end
 end
 
 ---@param ns integer
 ---@param buf integer
 function Extmark:hide(ns, buf)
-    if self.id ~= nil then
-        vim.api.nvim_buf_del_extmark(buf, ns, self.id)
-        self.id = nil
+    if self.id == nil then
+        return
     end
+    vim.api.nvim_buf_del_extmark(buf, ns, self.id)
+    self.id = nil
 end
 
 return Extmark

lua/render-markdown/health.lua

@@ -5,7 +5,7 @@ local state = require('render-markdown.state')
 local M = {}
 
 ---@private
-M.version = '8.2.1'
+M.version = '8.2.2'
 
 function M.check()
     M.start('version')

lua/render-markdown/init.lua

@@ -947,15 +947,15 @@ M.default_config = {
         -- @see :h 'conceallevel'
         conceallevel = {
             -- Used when not being rendered, get user setting.
-            default = vim.api.nvim_get_option_value('conceallevel', {}),
+            default = vim.o.conceallevel,
             -- Used when being rendered, concealed text is completely hidden.
             rendered = 3,
         },
         -- @see :h 'concealcursor'
         concealcursor = {
             -- Used when not being rendered, get user setting.
-            default = vim.api.nvim_get_option_value('concealcursor', {}),
-            -- Used when being rendered, disable concealing text in all modes.
+            default = vim.o.concealcursor,
+            -- Used when being rendered, show concealed text in all modes.
             rendered = '',
         },
     },

lua/render-markdown/lib/env.lua

@@ -41,7 +41,7 @@ function M.file_size_mb(file)
     local ok, stats = pcall(function()
         return M.uv.fs_stat(file)
     end)
-    if not (ok and stats) then
+    if not ok or stats == nil then
         return 0
     end
     return stats.size / (1024 * 1024)