# DocView Render your Markdown notes (to-do lists, project trackers, watch tables…) into clean, interactive **card-based panel views** — edits in the editor refresh the view instantly, and checking a box writes back to the source note immediately. **No scripts required.** ## What it solves Obsidian's native render of long tables, long lists, and large blocks of notes is hard to scan: tables overflow horizontally, hierarchy is unclear, status markers are not prominent. DocView re-lays your document into card-style panels using a simple **data contract** (an agreed Markdown writing convention), while your Markdown remains the single source of truth. ## Core features - **Two views**: a **Document view** (renders one contract note into draggable panels) and a **Project Kanban view** (aggregates every `项目卡片-*.md` across `scr/*/docs/` into status columns). Switch between them with a single button on the top bar. - **Bidirectional live sync**: edit Markdown in the editor and the view refreshes automatically; check a to-do in the view and the change is written precisely back to the matching line in the source. - **Data-contract driven**: `#` heading, `##` section cards, `- [ ]` checkable to-dos, `>` collapsible meta bars, status emoji rendered as colored badges, `[[wikilink]]` native jump — without changing how you write. - **Sticky top bar**: the title bar (with the view switch / refresh / file-select controls) stays pinned to the top while you scroll, so the controls are always one tap away. - **Draggable layouts**: reorder sections (Document view) or status columns (Kanban view) via the `⠿` handle or by dragging inside the catalog menu. Layout is saved in plugin data; the Markdown source is never touched. - **Per-document layout memory**: each document keeps its own panel order, stored independently. - **Multi-document management**: register any number of contract documents in settings; switch between them from a dropdown inside the view. Invalid paths are flagged with red text immediately. - **Floating navigation**: bottom-right ⬆ top / ⬇ bottom / 📑 section catalog (tap to open, current section highlighted). - **Built-in manual**: open the full data-contract guide from the settings panel — no need to hunt through docs. ## Usage 1. After enabling the plugin, click the dashboard icon in the left ribbon (or run "Open document view of current file" from the command palette). 2. On first use, register the document paths you want to view as panels in Settings → DocView (one path per line, with the `.md` extension). 3. Click "📖 Data contract manual" in settings to read the full writing spec. 4. To open the aggregated Kanban, click "📊 Project Kanban" on the Document view top bar, or use the command palette / ribbon. ## Manual install Copy `main.js`, `manifest.json`, and `styles.css` into your vault's `.obsidian/plugins/docview/` folder, then enable the plugin in Settings → Community plugins. ## License [MIT](LICENSE) --- ## 中文说明 把你的 Markdown 文档（待办清单、项目看板、追踪表……）渲染成结构清晰、可交互的面板视图——**改文档即时刷新，面板上打勾即时写回原文档，全程零脚本**。 **两种视图**：文档视图（把单篇契约文档渲染成可拖拽面板）+ 项目聚合看板（把 `scr/*/docs/` 下所有 `项目卡片-*.md` 按状态列聚合）。顶栏一键互切。 **核心特性** - **双向即时同步**：编辑器改 Markdown 视图自动刷新；视图里勾选待办精确写回源文件对应行 - **数据契约驱动**：`#` 大标题、`##` 版块卡片、`- [ ]` 可勾选待办、`>` 可折叠元信息条、状态 emoji 渲染为彩色徽章、`[[wikilink]]` 原生跳转——不改变写作习惯 - **顶栏常驻悬浮**：大标题栏钉在顶部，下滑时右上角切换/刷新/下拉控件始终可见可点 - **可拖拽布局**：文档视图拖「版块」、看板视图拖「状态列」（列头 ⠿ 手柄或目录内拖拽），布局存插件数据，Markdown 源一字不动 - **每文档独立布局记忆**：每篇文档各自记住面板顺序 - **多文档管理**：设置中登记任意数量的契约文档，视图内下拉切换；路径错误即时红字提示 - **悬浮导航组**：右下角 ⬆ 回顶部 / ⬇ 去底部 / 📑 版块目录（点击弹出，当前版块高亮） - **内置使用说明**：设置面板一键打开完整的数据契约使用说明