feature: optional preview-buffer rendering for wrapped, navigable tables
メンテナーはふだん 6 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 35/100
- issue の種類
- 機能追加
- 明瞭さ
- 説明が足りない
- 活発さ
- 活発
- 技術スタック
- lua, markdown, neovim
調査の方向性
まず既存のプレビューレンダラーと、ソースとプレゼンテーションの分離を読み、次にテーブルのレンダリングと更新動作を追跡します。プロトタイプで必要とされる投影、折り返し、ソースマッピング、リサイズ、編集／カーソル動作を、現在のインターフェースと比較します。合意されたオプションのプレビューモード、または対応する companion plugin インターフェースによって、ソース編集、保存、ナビゲーション、通常の Markdown レンダリングが維持されれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Is your feature request related to a problem? Please describe.
Long table cells are difficult to read in narrow windows. Wrapping the underlying Markdown line does not
preserve the table's column layout, while generated virtual lines require additional handling for cursor
movement, selection, and copying.
Related requests include #536 and
#616.
Describe the solution you'd like
I have implemented a prototype that renders tables as real text rows in a separate preview buffer, while
keeping the original Markdown buffer responsible for editing, undo history, and saving.
Short columns retain their natural width where space permits. The remaining width is distributed among
longer columns. Cell contents wrap at word boundaries, with oversized words or identifiers split when
necessary. Each table row expands to accommodate its tallest cell.
Ordinary Markdown around the table continues to use render-markdown.nvim.
Demonstration:
The GIF shows long descriptions wrapping beside aligned short cells, an oversized identifier splitting
across lines, cursor movement through wrapped content, visual selection and copying, and a quick status edit
followed by undo/redo.
Benefits
-
Readable tables within the window: long cells expand vertically while preserving column alignment.
-
Native navigation and copying: continuation rows are actual buffer lines, so movement, search, selection,
and yanking work on their text. -
Source-backed editing: supported edit commands return to the corresponding source cell; preview resumes
afterward. -
Incremental updates: unchanged table layouts can be cached, with only changed preview ranges updated.
Costs and limitations
The additional preview buffer requires memory, layout work, and source-position mappings. Those mappings
must account for wrapped lines, UTF-8, links, and inline formatting.
Editing also becomes more complex: the preview remains read-only, supported quick edits run in the source
buffer, and arbitrary visual edits require switching to source mode. Saving, modified state, link
navigation, and cursor restoration must preserve the source buffer's behavior.
The prototype demonstrates feasibility; it does not establish a performance improvement over the current
renderer.
Possible upstream support
The existing preview already separates source and presentation. Supporting this approach would additionally
require:
- Table projection into real display rows, with highlights and source mappings.
- A way to exclude generated table rows from ordinary Markdown parsing.
- Refresh handling for source edits and window resizing, with source-position preservation.
This could be an optional preview mode or a supported interface for a companion plugin.
The same projection interface could later support Mermaid diagrams through an external renderer, though
precise diagram-to-source mapping would require additional metadata.
Describe alternatives you've considered
Using a separate table-viewing plugin is another option. It could open large tables in a dedicated buffer with wrapping, navigation, and copying support.
Additional information
No response
- 主要言語
- Lua
- スター
- 5.2k
- フォーク
- 145
- PR マージ指標
- 30日以内にマージされた PR はありません
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
MeanderingProgrammer/render-markdown.nvim のほかの issue
-
enhancement
難易度 4/5 3〜5日 初心者へのやさしさ 55/100
MeanderingProgrammer/render-markdown.nvim#709 ·
メンテナーはふだん 6 日以内に返信
-
bug
難易度 4/5 1〜2日 初心者へのやさしさ 55/100
MeanderingProgrammer/render-markdown.nvim#706 ·
メンテナーはふだん 6 日以内に返信
-
enhancement
難易度 5/5 1週間以上 初心者へのやさしさ 38/100
MeanderingProgrammer/render-markdown.nvim#685 ·
メンテナーはふだん 6 日以内に返信
-
bug: Tables don't render correctly if the pipe at the end of line is missing対応中かも @samholmes が 94 日前に担当しました。 オープンbug
難易度 3/5 1〜2日 初心者へのやさしさ 55/100
MeanderingProgrammer/render-markdown.nvim#673 · コメント 2 件 ·
メンテナーはふだん 6 日以内に返信
-
enhancement
難易度 4/5 3〜5日 初心者へのやさしさ 48/100
MeanderingProgrammer/render-markdown.nvim#656 ·
メンテナーはふだん 6 日以内に返信
MeanderingProgrammer/render-markdown.nvim の issue をすべて見る
似ている issue
-
bug
難易度 1/5 1〜3時間 初心者へのやさしさ 85/100
bradcypert/plum#265 ·
メンテナーはふだん 1 日以内に返信
-
Lasso not Pastingオープンbug
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
-
code:todo
難易度 1/5 1時間未満 初心者へのやさしさ 72/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 83/100
koreader/koreader#16221 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
ibhagwan/fzf-lua#2828 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信