Repository navigation
Releases: kainnne/Kainnne-LumaReader
Release list
Kainnne LumaReader 1.5.0
Kainnne LumaReader 1.5.0
繁體中文
- PDF 匯出改為文件排版介面:文字與圖片板塊可拖動分欄、上下排序、群組與調整欄寬;多選、復原/重做、文字格式及獨立儲存均保留。排版資料與 Markdown 分開,修改 PDF 排版不會重排或覆寫原文。
- 紙張提供 A4、Letter、16:9、4:3 與直橫方向;字級改用拖桿。彩色外框、頁尾、頁碼和重點標註可調整,完成排版後直接匯出。表格按列延續、圖片等比例呈現,匯出不帶入把手、工具列或捲動條。
- 編輯模式選單提供一般編輯、原文及原文對照預覽;桌面另提供文件排版。編輯時隱藏文件頁籤,避免切換文件遺失草稿;閱讀時可拖動頁籤排序。
- 桌面、線上 Reader 和嵌入版使用同一套圓角細線圖示,滑鼠移上即可看到功能提示。桌面和一般網頁預設顯示閱讀方式;設定仍可調整顯示項目。嵌入版保留精簡預設、既有客製化設定、文件與註記接口。
- PDF 橫向把手採低飽和度細線滑片,與六點移動把手分開;拉伸限制在所在欄。靠右分欄更直覺,同一右欄可放多段短文。
- 桌面程式碼編輯改善縮排與行距,保留語法上色;閱讀時可選擇切換深色模式。支援本機 GIF 與網頁分享中內嵌 GIF 動畫。
- 大型本機資料夾掃描可顯示進度並逐批使用結果,搜尋包含資料夾名稱;閱讀和手機版不再因圖片載入或視窗尺寸變化微幅回捲。本機與網頁的相對圖片保留既有授權及自動配對流程。
- 桌面 App 新增 Agent 指令介面:
--luma-agent help、inspect、export。可用 JSON 排版稿輸出同一套 PDF,不改主介面、不改原始 Markdown,預設不覆寫 PDF。使用方式見 AGENT-PDF.md。
PDF 排版稿及桌面註記存在 App 的本機資料中,單獨複製 Markdown 不會帶走這些資料。嵌入網站的後台儲存仍由整合網站透過既有接口負責。
English
- PDF export opens a separate document-layout workspace. Drag text and image blocks into columns, reorder or group selections, adjust widths, edit formatting, and undo or redo changes. Saved PDF layouts remain separate from the original Markdown.
- Choose A4, Letter, 16:9 or 4:3 with portrait or landscape orientation. A size slider, colored frame, footer, page numbers and annotations remain configurable. Export directly after arranging the document; tables continue by row, images retain their proportions, and controls or scrollbars are excluded.
- Choose normal editing, Markdown source, or source with preview from one menu. Desktop also includes document layout. Tabs can be reordered while reading and are hidden during editing to protect drafts.
- Desktop, Web and embedded readers share one rounded line-icon system with immediate function hints. Reading mode appears by default on desktop and standalone Web; embedded readers preserve compact defaults, host configuration, and existing document and annotation APIs.
- Muted fine-line horizontal handles are separated from the six-dot movement grips and constrained to their column. Multiple short passages can stack in one right column.
- Desktop code editing improves indentation and line spacing while retaining syntax highlighting and optional dark-mode guidance. Local GIFs and self-contained GIF images in Web shares retain animation.
- Large desktop libraries show scan progress and make partial results available. Search includes folder names. Image loading and viewport changes no longer nudge the reading position. Existing authorized image-matching flows remain available.
- The desktop executable includes
--luma-agent help,inspect, andexport, using the same PDF renderer and JSON layout data without changing the normal UI or source Markdown. Existing output files are protected by default. See AGENT-PDF.md.
Desktop PDF layouts and annotations are stored separately in app-local data. Embedded hosts remain responsible for backend persistence through the existing APIs.
Downloads
- macOS: pink production icon, Universal Apple silicon / Intel, Developer ID signed, notarized and stapled after release validation.
- Windows: x64 Setup and Portable, unsigned; Windows may show SmartScreen.
- Linux: x64 AppImage and .deb, validated on Ubuntu 22.04 and 24.04 before publication.
- Standard download packages start in English. All 11 interface languages remain available in Settings; existing language preferences are preserved. The download chooser enables only published language editions.
The app does not automatically change the operating system's default Markdown handler.
Kainnne LumaReader 1.4.2
Kainnne LumaReader 1.4.2
繁體中文
- 反白文字後可加入重點、文字備註或圖片註記。註記另外儲存,不會把符號或圖片寫進 Markdown 原文;圖片可拖入,滑過註記時預覽。
- 閱讀模式也能加入註記並自動儲存。半透明工具列可切換至下方中央或右下角,並記住位置;儲存失敗時保留註記並提供重試。
- 匯出 PDF 可選擇是否帶入畫好的重點,並在儲存前查看實際預覽。
- 桌面主選單新增 Settings,顯示項目、配色、深淺色與語言和右側設定同步。預設保留編輯、閱讀方式與設定齒輪;隱藏齒輪後仍可由主選單或 Cmd/Ctrl+, 開啟設定。
- Edit/編輯改為置中的純文字,維持原本字級。原文切換鈕顯示「顯示原文」或「返回直接編輯」;對照預覽移到儲存左側,切換與儲存狀態變化時不再推動其他按鈕。
- Web 與嵌入版同步純文字編輯按鈕和註記工具列改善,既有嵌入指令與資料接口維持相容。
註記保存在 App 的本機資料中,單獨複製 Markdown 不會帶走註記。嵌入網站須透過既有註記快照及附件接口自行保存資料;不會自動接上網站後台。
English
- Add highlights, comments, and image annotations to selected text without rewriting the Markdown document. Drop an image onto an image annotation and hover its mark to preview it.
- Reading-mode annotations save separately and automatically. A translucent toolbar can dock at the bottom center or bottom right. Failed saves retain the notes and offer a retry.
- Optionally include highlights in exported PDFs and review the actual PDF before saving.
- A native Settings menu mirrors the desktop panel. Edit, reading mode, and Settings appear by default; Cmd/Ctrl+, remains available when the gear is hidden.
- Edit is a centered text label at its original size. Source editing uses Show source / Visual editor labels, with comparison preview to the left of Save and stable action positions.
- Web and embedded readers receive the text-only Edit treatment and annotation toolbar refinements, preserving existing installation commands and integration contracts.
Desktop annotations are stored in app-local data and do not travel with a copied Markdown file. Embedded hosts must persist annotation snapshots and attachments through the existing APIs.
Downloads
- macOS: Universal Apple silicon / Intel build, signed, notarized, and stapled; standard pink icon.
- Windows: x64 Setup and Portable, unsigned. Windows may show a SmartScreen warning.
- Linux: x64 AppImage and .deb, validated on Ubuntu 22.04 and 24.04.
The app does not automatically change the operating system's default Markdown handler.
Kainnne LumaReader 1.4.1
Kainnne LumaReader 1.4.1
繁體中文
- 匯出 PDF 前可逐頁預覽實際結果,調整 A4/Letter 紙張、字級與留白。儲存使用預覽中的同一份 PDF,不會再次排版。
- 新增「微調分頁」:選擇段落或區塊後,可指定從本段換頁、接續前段以減少留白,或本段盡量同頁。可一鍵重設;設定只影響本次匯出,不修改 Markdown。
- 長表格可逐列跨頁並重複顯示欄位標題;長引用與程式碼區塊可接續下一頁,減少整塊跳頁造成的留白。
- 彩色外框的底部留白縮小,頁尾名稱改為灰色,並對齊外框與紙張底部之間的位置。外框沿用目前色系;頁尾與外框仍可獨立關閉。
- 加強繁體中文粗體的辨識度。既有直接編輯、原文與對照預覽、圖片、表格及程式碼功能保留。
超過一頁高度的單一表格列或圖片仍可能需要調整原文。「本段盡量同頁」不會強制將超長內容塞進一頁。既有 <!-- lumareader:pagebreak --> 分頁標記仍可使用。
網站另提供較精簡的手機工具列與免費嵌入工具;可在 嵌入說明頁 試用並載入自己的 Markdown。
English
- Preview the actual PDF before saving. Adjust A4/Letter paper, text size and margins; saving writes the exact preview bytes without another print pass.
- Apply per-export pagination adjustments to individual sections: start a new page, continue after the previous section, or keep the section together where possible. Reset these adjustments at any time; the Markdown source is unchanged.
- Long tables flow by row with repeated column headings. Long quotes and code blocks can continue across pages, reducing unnecessary blank space.
- Refined optional palette-colored frame with less bottom space and a subtle gray footer name centered between the frame and page bottom. Footer and frame remain independent options.
- Clearer Chinese bold text. Existing direct/source editing, comparison preview, images, tables and basic code editing remain available.
A table row or image taller than a printable page may still need document adjustments. Keep-together is best effort. Existing Markdown page-break markers remain supported.
macOS: pink production icon, Universal, Developer ID signed and Apple notarized. Windows: unsigned x64 Setup and Portable; SmartScreen or Unknown Publisher warnings may appear. Linux: x64 AppImage and .deb. Existing OS default-app choices remain under user control.
Kainnne LumaReader 1.4.0
Kainnne LumaReader 1.4.0
繁體中文
- 直接編輯成為預設:點排好版的文字或表格即可修改。開啟「顯示 Markdown」會顯示原文與對照預覽,取消後回到直接編輯。
- 格式選單預設提供功能名稱與用途說明,也能勾選精簡顯示。直接編輯支援表格列欄操作、格式復原、圖片插入與放大。
- 修正獨立公式在閱讀與編輯時對齊不同的問題,改善多層分數的顯示。
- 桌面選圖使用非同步視窗與等待提示,避免重複開啟;實際開啟時間仍依作業系統和檔案位置而異。
- 桌面版新增 Python、C、C++、JavaScript、TypeScript 等常見程式碼檔案的語法上色、行號與基本編輯。格式預設未勾選,檔案預設唯讀,每次編輯需自行開啟;不會執行程式。
- 網頁版同步更新直接編輯與「顯示 Markdown」開關,保留最多 3 份文件、分享及暫存使用方式。
較複雜、未支援直接編輯的 Markdown 區塊會保留原文,並提供原文編輯入口;修改支援的區塊時可能整理該區塊的 Markdown 語法。超過 500,000 字元的 Markdown 使用原文編輯;程式碼檔案上限 1 MB,超過 200,000 字元暫停語法上色。
macOS 為粉紅色正式圖示、Universal 版本,使用 Developer ID 簽章與 Apple 公證。Windows 為未簽署的 x64 安裝版及免安裝版,可能出現 SmartScreen 或「未知的發行者」提示。Linux 提供 x64 AppImage 與 .deb。程式不會自行更改 Markdown 預設開啟方式。
English
- Edit formatted text and table cells directly by default. Enable Show Markdown for source and comparison preview; disable it to return to direct editing.
- Formatting tools include names and explanations, with optional compact labels. Direct editing supports table row/column operations, formatting undo, image insertion and zoom.
- Display formulas now align consistently in reading and editing, including nested fractions.
- Desktop image selection uses an asynchronous native panel with visible progress and duplicate-request protection. OS and file-location latency can still vary.
- Desktop adds highlighted, line-numbered reading and basic editing for Python, C, C++, JavaScript and TypeScript files. Code formats are opt-in; each document opens read-only until editing is enabled. No code is executed.
- Web receives the direct editor and Show Markdown toggle while retaining its three-document session and sharing behavior.
Unsupported direct-editing blocks retain their source and offer source editing. Editing supported blocks may normalize their Markdown syntax. Markdown above 500,000 characters uses source editing. Code files are limited to 1 MB, with syntax parsing paused above 200,000 characters.
macOS: pink production icon, Universal, Developer ID signed and Apple notarized. Windows: unsigned x64 Setup and Portable; SmartScreen or Unknown Publisher warnings may appear. Linux: x64 AppImage and .deb. Existing OS default-app choices remain under user control.
Kainnne LumaReader 1.3.1
Kainnne LumaReader 1.3.1
Editing
- Preview reflow no longer scrolls the Markdown source while typing, including unequal source/preview widths. Deliberate scrolling continues to synchronize the panes; the editor can still reveal the caret when it reaches the edge.
- Formatting, image insertion, and indentation use native editing history alongside typing, so Undo and Redo work consistently. The Insert menu preserves the visible text selection while choosing a format.
- Comparison preview starts enabled for new Web and Desktop users. A saved choice to turn it off remains respected.
PDF export
- Separate checkboxes control the footer name and the palette-colored frame. Both initially remain unchecked for plain white pages without a decorative frame or footer name.
- Successful exports remember the name and both options across windows and restarts. Turning the footer off keeps the saved name for later; canceling or a failed export does not replace your choices.
- Manual page breaks (
<!-- lumareader:pagebreak -->), Markdown rendering, and rounded colored frames continue to work.
Website and Web reader
- Traditional Chinese copy has been revised for natural Taiwanese wording while retaining the original meaning.
- The demo still lists macOS, Windows, and Linux downloads and a link back to the homepage. The official Kainnne header logo is preserved.
Downloads
- macOS: Universal DMG and ZIP for Apple silicon and Intel, Developer ID signed and notarized by Apple.
- Windows: x64 Setup and Portable. These packages remain unsigned; SmartScreen or an unknown-publisher prompt may appear.
- Linux: x64 AppImage and .deb; tested on Ubuntu 22.04 and 24.04 with Chromium sandboxing enabled.
- Default Markdown applications remain the user's operating-system choice. The app does not rewrite defaults or reset system association databases.
繁體中文
- 修正編輯時預覽換行帶動原文跳動的問題,原文與預覽寬度不同時也能穩定輸入;主動捲動仍會同步對照位置。
- 粗體、插入圖片與縮排都能和一般輸入一樣復原、重做。點開插入選單選擇格式時,原本選取的文字會維持反白。
- 網頁版與桌面版的新用戶,首次編輯時都會開啟對照預覽;自行關閉後,仍會沿用你的設定。
- 匯出 PDF 前,可分別勾選「加上頁尾名稱」與「加上彩色外框」。第一次預設都不勾選,輸出白底、沒有外框與頁尾名稱的版本;成功匯出後會記住選項。取消勾選頁尾不會清掉公司名稱。
- 保留原有的指定換頁功能,並調整網站與網頁閱讀器的繁中用語,讓說明更符合台灣的閱讀習慣。
Kainnne LumaReader 1.3.0
Kainnne LumaReader 1.3.0
Read and edit local Markdown with clearer folder search, predictable wrapping, and more flexible PDF output.
- Folder indexing continues in bounded batches instead of dropping subfolders after the old scan limit. Incomplete, inaccessible, or cloud-backed folders have visible status and a refresh hint.
- Search matches document paths and folder names, handles Unicode normalization, and expands matching folders. Large results load in batches to keep the interface responsive.
- Comparison preview defaults to on after this upgrade. Source and editor text wrap to the available width in vertical views; subsequent preview choices are remembered.
- PDF export offers a selected, editable footer name. Keep LumaReader, enter your company, or leave it blank. Successful exports remember the choice across windows and restarts. The footer now sits at the bottom right with readable spacing. The rounded paper frame has clean corners, and page margins follow the selected palette with a light tint.
- Add
<!-- lumareader:pagebreak -->on its own line between sections to begin a new PDF page. See PDF export instructions. - A dismissed tour no longer reopens from an old timer. Opening Settings after resizing keeps the menu available while layout updates settle.
- Linux x64 is available as an AppImage and
.deb. The release workflow verifies Ubuntu 22.04 and the same.debon Ubuntu 24.04; prefer.debon Ubuntu 24.04. See Linux compatibility. - The website focuses on personal developers working with local documents. A more visible Web trial entry accompanies desktop downloads; Web download links select the current desktop platform directly.
macOS downloads are Universal, Developer ID signed and notarized. Windows x64 Setup and Portable downloads remain unsigned. Linux downloads are not signed distribution-repository packages. SHA-256 checksums accompany all downloads. File associations remain a manual choice in the operating system; installation and launch preserve an existing Markdown default.
Kainnne LumaReader 1.2.0
Kainnne LumaReader 1.2.0
Released September 6, 2026.
English
- Open a Markdown file from macOS or Windows directly into an editable window. Its containing folder appears in the sidebar. Separate files keep separate windows and unsaved edits; reopening the same file focuses its existing window. Up to eight windows can be open at once.
- Vertical reading, source view, and editing now wrap long text to the available width. Live preview scrolling accounts for wrapped source lines. These changes also ship in LumaReader Web.
- Source, Media, and Export PDF start hidden. Enable them in Settings when needed. Upgrading applies the new PDF default once; subsequent user choices remain saved. PDF export is available in the desktop edition.
- The guide explains how to choose LumaReader as the default Markdown app yourself. The application does not register protocols or change system defaults at launch. macOS bundles and Windows installers still declare supported Markdown file types for Open With. Windows installation and removal preserve existing extension defaults; macOS declares LumaReader as an alternate handler.
- Desktop windows have separate document folders and authenticated local services. Saving checks for external changes and replaces the file after writing a temporary copy. Folder scans, includes, diagram rendering, and simultaneous windows have resource limits. Large documents use a plain-text preview.
Downloads: macOS Universal (Apple silicon and Intel), Developer ID signed and notarized by Apple. Windows x64 Setup and Portable are unsigned; Windows may show SmartScreen or Unknown publisher.
Scope: Web edits stay in the current browser session and do not overwrite the original local file. Creating a share link sends a temporary document copy to the share service for 30 days. Remote document media may contact its origin. These safeguards reduce specific risks; signing and tests are not a guarantee that every document or machine is free from faults.
繁體中文
- 從 macOS 或 Windows 點開 Markdown,即可在可編輯的獨立視窗中開啟,左側顯示檔案所在資料夾。各視窗保留自己的文件與未儲存修改;重開同一檔案會回到既有視窗,最多同時 8 個視窗。
- 直式閱讀、原文檢視與編輯文字會依可用寬度自動換行,即時預覽同步捲動也會計入換行後的位置。網頁版同步更新。
- Source、Media 與 Export PDF 預設收起,需要時可在設定中開啟。升級會套用一次新的 PDF 預設值,之後會保留使用者自行調整的選擇;PDF 匯出為桌面版功能。
- 導覽說明如何自行在 Finder 或 Windows 設定中選取 Markdown 預設程式。App 不會在啟動時註冊通訊協定或更改系統預設值;Mac App 與 Windows 安裝程式仍宣告支援的檔案格式,讓系統可提供「打開方式」選項。Windows 安裝與移除會保留原有副檔名預設值;Mac 則宣告為可選的替代開啟程式。
- 桌面視窗使用各自的資料夾與具存取憑證的本機服務。儲存前檢查外部修改,先寫入暫存檔再替換原檔;資料夾掃描、內容引用、圖表渲染與同時開啟的視窗都設有資源限制。大型文件使用純文字預覽。
**下載:**Mac Universal 支援 Apple 晶片與 Intel,具 Developer ID 簽章並通過 Apple 公證。Windows x64 提供安裝版與免安裝版,目前未簽章,可能出現 SmartScreen 或未知發行者提示。
**使用範圍:**網頁版修改保留於目前瀏覽器工作階段,不會覆寫電腦裡的原檔。建立分享連結時會暫存文件分享副本 30 天,遠端媒體可能連線至來源網站。上述措施可降低特定風險;簽章與測試不能保證所有文件及電腦都不會遇到問題。
Kainnne LumaReader 1.1.0
Kainnne LumaReader 1.1.0
Version 1.1.0 makes Markdown editing more deliberate while keeping LumaReader focused on local reading and personal control.
What changed
- Added an Insert menu for headings, emphasis, links, quotes, code, tasks, tables, and images.
- Images can be chosen or dropped into the editor. The desktop app copies them into a portable folder beside the Markdown document and inserts the relative syntax automatically.
- Kept the editor and preview at the same visible position when inserting Markdown structures.
- Added a confirmation dialog before unsaved edits are discarded.
- Combined light/dark appearance, all 22 palettes, language, and individual toolbar visibility under one larger Settings gear. Source and Media begin hidden, and the palette panel remains open while comparing styles.
- Updated the first-launch guide to introduce Settings as a core part of the interface.
- Refined PDF page spacing, softened the page frame, and placed a lower-opacity
Kainnne LumaReadermark near the outer lower-right corner of every page. - Added system file associations for
.md,.markdown,.mkd, and.mdx. LumaReader now appears in Open With and can be chosen as the default Markdown app. - Replaced the product icon throughout the app, website, Web Reader, and browser-extension assets.
- Brought the same Settings, Insert, image, and unsaved-edit behavior to LumaReader Web while preserving its three-document, no-folder-library, and no-PDF boundaries.
- Added a privacy-minimal combined macOS + Windows download counter. Counting starts with v1.1.0 and stores only platform totals.
Distribution notes
The macOS Universal build supports Apple silicon and Intel Macs. It is signed with Developer ID, notarized by Apple, and validated by Gatekeeper in the release workflow.
The Windows x64 Setup and Portable builds remain unsigned. Windows may therefore show Microsoft Defender SmartScreen or Unknown publisher warnings even when the files are downloaded from the official release.
LumaReader remains free, open source, and local-first. Download only from lumareader.kainnne.com or the official GitHub Release.
Assets
Kainnne-LumaReader-1.1.0-macOS-universal.dmg
Kainnne-LumaReader-1.1.0-macOS-universal.zip
Kainnne-LumaReader-1.1.0-Windows-x64-Setup.exe
Kainnne-LumaReader-1.1.0-Windows-x64-Portable.exe
Kainnne-LumaReader-1.1.0-SHA256SUMS.txt
Kainnne LumaReader 1.0.2
Kainnne LumaReader 1.0.2
Version 1.0.2 adds PDF export to the local-first Markdown reader for macOS and Windows, alongside the public LumaReader Web edition.
What changed
- Export the reading view as PDF. A new PDF button sits with the document actions in the toolbar and opens the native system save dialog.
- Complete A4 print layout. The export waits for fonts and images, preserves print backgrounds, and keeps headings, code, tables, diagrams, mathematics, and images readable across pages.
- Desktop-only export. PDF export uses the installed application and never uploads the document for online processing.
- LumaReader Web. The website now provides the reader and editor at
/web/, with the complete reading controls, editing preview, and a three-document browser-session limit. - Intentional web boundaries. Web documents remain in the current tab and are cleared on reload or close. Individual files can be removed to free a slot. The web edition does not provide folder libraries, document downloads, cloud persistence, or PDF export.
Downloads
- macOS: Universal DMG and ZIP for Apple silicon and Intel Macs. The application is signed with Developer ID and notarized by Apple.
- Windows: x64 Setup and Portable executables. These builds are unsigned, so Windows may show Microsoft Defender SmartScreen or unknown-publisher warnings.
LumaReader remains free, open source, and local-first. Download only from lumareader.kainnne.com or the official GitHub Release.
Files
Kainnne-LumaReader-1.0.2-macOS-universal.dmg
Kainnne-LumaReader-1.0.2-macOS-universal.zip
Kainnne-LumaReader-1.0.2-Windows-x64-Setup.exe
Kainnne-LumaReader-1.0.2-Windows-x64-Portable.exe
Kainnne-LumaReader-1.0.2-SHA256SUMS.txt
Kainnne LumaReader 1.0.1
Kainnne LumaReader 1.0.1
Version 1.0.1 is a focused editing update for the local-first Markdown reader on macOS and Windows.
What changed
- Reach the true preview bottom when needed. Normal synchronized scrolling stays unchanged. When the source reaches the end but the rendered preview still has content below, a Show bottom button appears inside the preview.
- Clear feedback while editing. Selecting another Markdown file during editing now shows a palette-matched notice that reminds you to save or exit editing first.
Downloads
- macOS: Universal DMG and ZIP for Apple silicon and Intel Macs. The application is signed with Developer ID and notarized by Apple.
- Windows: x64 Setup and Portable executables. These builds are unsigned, so Windows may show Microsoft Defender SmartScreen or unknown-publisher warnings.
LumaReader remains free, open source, and local-first. Download only from lumareader.kainnne.com or the official GitHub Release.
Files
Kainnne-LumaReader-1.0.1-macOS-universal.dmg
Kainnne-LumaReader-1.0.1-macOS-universal.zip
Kainnne-LumaReader-1.0.1-Windows-x64-Setup.exe
Kainnne-LumaReader-1.0.1-Windows-x64-Portable.exe
Kainnne-LumaReader-1.0.1-SHA256SUMS.txt