在 markdown.nvim 中自定义悬浮窗口高度的技术方案

背景介绍

markdown.nvim 是一个 Neovim 插件，主要用于渲染和显示 Markdown 内容。在最近的版本更新中，该插件增加了对 LSP 悬浮窗口大小调整的支持，但在实际使用中发现了一个显示问题：当 LSP 返回的内容较少时，由于窗口高度计算存在偏差，会导致内容显示不完整。

问题分析

该问题具体表现为：

1. 当 LSP 返回简短内容时，悬浮窗口会出现高度计算不足的情况
2. 主要原因是窗口中的"标签行"占用了额外的一行空间
3. 这导致实际渲染的文本内容比预期少显示一行

解决方案

最新版本的 markdown.nvim 通过引入 on.initial 回调函数解决了这个问题。开发者可以在这个回调中自定义窗口的高度调整逻辑。

实现方式

require('render-markdown').setup({
    on = {
        initial = function(ctx)
            local height = vim.api.nvim_win_text_height(ctx.win, {}).all
            vim.api.nvim_win_set_height(ctx.win, height + 1)
        end,
    },
})

技术细节

1. on.initial 回调会在首次向缓冲区添加标记之前执行
2. 回调函数接收一个上下文对象 ctx，包含缓冲区和窗口的 ID
3. 使用 nvim_win_text_height API 获取窗口当前文本高度
4. 通过 nvim_win_set_height 调整窗口高度

高级应用

对于更复杂的使用场景，开发者可以：

1. 根据内容类型实现条件高度调整
2. 结合其他插件（如 hovercraft.nvim）实现更精细的布局控制
3. 实现动态高度调整算法，根据内容长度自动优化显示效果

注意事项

1. 此方案适用于所有缓冲区，如需特定于 LSP 悬浮窗口，需要额外判断逻辑
2. 高度调整应谨慎进行，避免过度调整影响用户体验
3. 建议在实际使用前充分测试不同内容长度的显示效果

总结

markdown.nvim 通过灵活的配置选项，为开发者提供了强大的窗口布局控制能力。通过合理使用 on.initial 回调，可以解决各种显示布局问题，实现更加优雅的内容展示效果。这一改进不仅解决了特定场景下的显示问题，也为插件的自定义能力开辟了新的可能性。