README file from
Githubtugtile
English
A card table for your Markdown notes in Obsidian — tug tiles to reorder.
tugtile lays a Markdown note out like cards on a table — every - [ ] task-list item
becomes a tile you can pick up and tug somewhere better, and ## headings are the
lanes the tiles line up in. Your table is a plain .md file: tug a tile and the
file updates; edit the file and the board updates. Nothing is locked inside a database
or a proprietary format.
Coming from obsidian-kanban?
tugtile's native tongue is tiles — but it also speaks fluent kanban. Boards from the (GPL, now-unmaintained)
obsidian-kanban just open — same
frontmatter, same - [ ] cards, same %% kanban:settings %% block, same *** archive —
and tugtile keeps the original markers in place until you choose to upgrade a board, so
going back stays possible. What you gain on top: undo / redo, an editor built for phones
and iPads, and active maintenance.
tugtile actually started life as plugins for obsidian-kanban — until rebuilding the whole table was easier than patching someone else's. Written from scratch (clean-room), MIT.
Highlights
- Never lose a card — built-in undo / redo, a backup before the first write, and overwrite protection: if the file changes elsewhere, tugtile reloads instead of clobbering it. (Backed by a data-safety test suite.)
- An editor that survives phones — two-row toolbar, virtual-keyboard-aware layout on iOS/iPad; tug lanes & tiles to reorder, dates/times, tags, stash (archive).
- Your data stays Markdown — human-readable, diff-friendly, portable. Board and Table views over the same note, plus a raw-editor button when you want the text itself.
- CJK-first, concretely — re-highlighting waits while your IME is composing, so CJK
input is never interrupted;
#tagsaccept CJK; sorting is locale-aware. - No network, no telemetry — your boards never leave your vault.
Install
- Community plugins (recommended): in Obsidian, open Settings → Community plugins → Browse, search for tugtile, then Install and Enable.
- Manual: from the latest release, download
main.js,manifest.json, andstyles.cssinto your vault's.obsidian/plugins/tugtile/folder, then enable tugtile in Settings → Community plugins. - BRAT (beta builds): add
CVERInc/tugtile.
Sister plugin: marktile — the same editor as a standalone Markdown pane.
日本語
Obsidian の中の、Markdown ノートのためのカードテーブル。タイルをつまんで並べ替え。
tugtile は Markdown ノートを、テーブルに広げたカードのように扱います：- [ ] のタスク
リスト項目が一枚一枚のタイルになり、つまんで好きな場所へ動かせます。## 見出しは
タイルが並ぶ列です。テーブルはそのまま素の .md ファイル：タイルを動かせばファイルが
更新され、ファイルを編集すればボードが更新されます。データベースや独自フォーマットに
閉じ込められることはありません。
obsidian-kanban からの乗り換え
tugtile の母語はタイル。でも kanban 語もペラペラです。（GPL でメンテ終了の）
obsidian-kanban のボードはそのまま開きます：
同じ frontmatter、同じ - [ ] カード、同じ %% kanban:settings %% ブロック、同じ
*** アーカイブ。そして、あなたが「アップグレード」を選ぶまで元のマーカーをそのまま
保持します。いつでも戻れます。乗り換えで増えるもの：取り消し／やり直し、スマホと iPad の
ために作られたエディタ、そして現役のメンテナンス。
tugtile の前身は、obsidian-kanban のために書いた plugin の山（plugin の plugin）でした。 他人のテーブルを直し続けるより、テーブルごと作り直すほうが早かった。ゼロから書かれた （クリーンルーム）MIT 実装です。
ハイライト
- カードを失わない：取り消し／やり直しを内蔵、最初の書き込み前にバックアップ、 ファイルが外部で変わったら上書きせず再読み込み。（データ安全テストで保証）
- スマホで生き残るエディタ：2 段ツールバー、iOS／iPad の仮想キーボードに追従する レイアウト。列もタイルもつまんで並べ替え、日付／時刻、タグ、アーカイブ。
- データはずっと Markdown：人間が読めて、diff しやすく、持ち運べます。同じノートを ボード／表の 2 ビューで。テキストそのものを触りたいときは raw エディタボタンも。
- CJK ファースト、具体的に：IME の変換中は再ハイライトを待機し、日本語入力を決して
中断しません。
#タグも CJK 対応、並べ替えはロケールを認識します。 - ネットワークなし、テレメトリなし：ボードが vault の外に出ることはありません。
インストール
- コミュニティプラグイン（推奨）： 設定 → コミュニティプラグイン → 「閲覧」で tugtile を検索し、インストールして有効化。
- 手動： 最新リリース から
main.js・manifest.json・styles.cssを vault の.obsidian/plugins/tugtile/に置き、設定 → コミュニティプラグイン で tugtile を有効化。 - BRAT（ベータ版）：
CVERInc/tugtileを追加。
姉妹プラグイン：marktile：同じエディタを、独立した Markdown ペインとして。
한국어
Obsidian 안의 Markdown 노트를 위한 카드 테이블: 타일을 끌어서 정렬.
tugtile은 Markdown 노트를 테이블 위에 펼친 카드처럼 다룹니다: - [ ] 작업 목록 항목
하나하나가 집어서 더 좋은 자리로 옮길 수 있는 타일이 되고, ## 제목은 타일이
늘어서는 열이 됩니다. 테이블은 그 자체로 평범한 .md 파일입니다: 타일을 옮기면
파일이 갱신되고, 파일을 편집하면 보드가 갱신됩니다. 데이터베이스나 독자 포맷에 갇히는
것은 아무것도 없습니다.
obsidian-kanban에서 옮겨오시나요?
tugtile의 모국어는 타일이지만, kanban도 유창하게 구사합니다. (GPL, 유지보수가 중단된)
obsidian-kanban의 보드가 그대로 열립니다:
같은 frontmatter, 같은 - [ ] 카드, 같은 %% kanban:settings %% 블록, 같은 ***
아카이브. 그리고 "업그레이드"를 직접 선택하기 전까지 원래 마커를 그대로 유지합니다.
언제든 돌아갈 수 있습니다. 옮겨오면 얻는 것: 실행 취소/다시 실행, 휴대폰과 iPad를 위해
만들어진 에디터, 그리고 활발한 유지보수.
tugtile은 원래 obsidian-kanban을 위해 쓴 플러그인들(플러그인의 플러그인)에서 시작했습니다. 남의 테이블을 계속 고치는 것보다 테이블째 새로 만드는 편이 빨랐습니다. 처음부터 새로 작성된(clean-room) MIT 구현입니다.
하이라이트
- 카드를 잃지 않습니다: 실행 취소/다시 실행 내장, 첫 쓰기 전 백업, 파일이 외부에서 바뀌면 덮어쓰지 않고 다시 읽기.（데이터 안전 테스트로 보장）
- 휴대폰에서 살아남는 에디터: 2단 툴바, iOS/iPad 가상 키보드를 따라가는 레이아웃, 열과 타일을 집어서 정렬, 날짜/시간, 태그, 보관함.
- 데이터는 언제나 Markdown: 사람이 읽을 수 있고, diff 친화적이며, 어디로든 가져갈 수 있습니다. 같은 노트를 보드/표 두 가지 뷰로, 텍스트를 직접 만지고 싶을 때는 raw 에디터 버튼도 있습니다.
- CJK 우선, 구체적으로: IME 조합 중에는 재하이라이트를 멈춰 한국어 입력이 끊기지
않습니다.
#태그도 CJK 지원, 정렬은 로케일 인식 비교를 사용합니다. - 네트워크 없음, 텔레메트리 없음: 보드는 vault 밖으로 나가지 않습니다.
설치
- 커뮤니티 플러그인(권장): 설정 → 커뮤니티 플러그인 → 「탐색」에서 tugtile을 검색해 설치하고 활성화하세요.
- 수동: 최신 릴리스에서
main.js,manifest.json,styles.css를 vault의.obsidian/plugins/tugtile/에 넣고, 설정 → 커뮤니티 플러그인에서 tugtile을 활성화하세요. - BRAT(베타 빌드):
CVERInc/tugtile추가.
자매 플러그인: marktile: 같은 에디터를 독립된 Markdown 패널로.
繁體中文
在 Obsidian 裡為你的 Markdown 筆記開一張牌桌：拖一下牌，就排好。
tugtile 把一份 Markdown 筆記攤成一桌牌：每個 - [ ] 任務項目是一張牌，拿起來就能
拖到更好的位置；## 標題是牌排成的牌列。你的牌桌就是一個素的 .md 檔：拖牌，
檔案就更新；改檔案，牌桌就更新。沒有任何東西被鎖進資料庫或私有格式。
從 obsidian-kanban 搬過來？
tugtile 的母語是牌，但 kanban 也說得一口流利。（GPL、已停止維護的）
obsidian-kanban 的檔案直接打開就能用：
相同的 frontmatter、相同的 - [ ] 卡片、相同的 %% kanban:settings %% 區塊與相同的
*** 封存：而且在你主動選擇「升級」之前，tugtile 原樣保留原本的標記，隨時可以回頭。
搬過來多得到的：復原／重做、為手機與 iPad 打造的編輯器，以及仍在活躍的維護。
tugtile 的前身正是幫 obsidian-kanban 寫的一堆 plugin（plugin 的 plugin），直到重做一整張 牌桌比繼續打補丁更快。從零寫起（clean-room）、MIT 授權。
亮點
- 絕不掉牌：內建復原／重做、首次寫入前先備份、外部改檔時自動重載而非覆寫 （由資料安全測試套件守護）。
- 在手機上活得下來的編輯器：雙排工具列、iOS／iPad 虛擬鍵盤自動避讓；牌列與牌都能 拖曳排序，加上日期／時間、標籤、收牌（牌庫）。
- 資料永遠是 Markdown：人類可讀、好 diff、帶得走。同一份筆記有牌桌／牌表兩種檢視， 想直接碰文字時還有 raw 編輯器按鈕。
- CJK 優先，而且講得出細節：IME 組字期間暫停重新上色，中文輸入絕不被打斷；
#標籤支援 CJK；排序使用 locale 感知比較。 - 不連網、零遙測：你的牌桌永遠不會離開 vault。
安裝
- 社群外掛（推薦）： 在 Obsidian 開 設定 → 社群外掛 → 瀏覽，搜尋 tugtile， 安裝後啟用。
- 手動： 從最新 release 下載
main.js、manifest.json、styles.css放進 vault 的.obsidian/plugins/tugtile/，然後在 設定 → 社群外掛 啟用 tugtile。 - BRAT（beta 版）： 加入
CVERInc/tugtile。
姊妹外掛：marktile：同一顆編輯器，作為獨立的 Markdown 分頁。
Published by CVER Inc. · cver.net · MIT License.