to_markdown_gui 0.6.2

Desktop Markdown/vault viewer for toMarkdownMCP (Tauri)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

# toMarkdown-viewer


[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Rust](https://img.shields.io/badge/Rust-1.88+-ce422b?logo=rust)](https://www.rust-lang.org/)
[![Node.js](https://img.shields.io/badge/Node.js-18+-339933?logo=node.js)](https://nodejs.org/)

Desktop Markdown vault viewer for [toMarkdownMCP](https://github.com/carlomagnoglobal/toMarkdownMCP).

A cross-platform Tauri application that provides a beautiful, feature-rich viewer for exploring Markdown vaults with advanced features including:

- **Multi-tab interface** with keyboard shortcuts and navigation
- **Recycle bin** for safe file deletion with configurable retention
- **Clipboard operations** with multiple encoding formats (Base64, Hex, Markdown)
- **Image zoom** with pan capability (1x to 15x magnification)
- **Syntax highlighting** for code files
- **Vault indexing** with co-occurrence analysis and word graphs
- **Dark/Light/Sepia themes** with full keyboard navigation
- **Advanced file operations** including search, preview, and recent files

## Installation


### macOS

```bash
# Apple Silicon

wget https://github.com/carlomagnoglobal/toMarkdown-viewer/releases/download/gui-v0.6.2/toMarkdown.Viewer_0.6.2_aarch64.dmg
open toMarkdown.Viewer_0.6.2_aarch64.dmg

# Intel

wget https://github.com/carlomagnoglobal/toMarkdown-viewer/releases/download/gui-v0.6.2/toMarkdown.Viewer_0.6.2_x64.dmg
open toMarkdown.Viewer_0.6.2_x64.dmg
```
The app is unsigned, so macOS Gatekeeper will block it on first launch. Right-click
the app in Finder and choose **Open** to bypass this once.

### Windows

Download and run the installer from the
[latest release](https://github.com/carlomagnoglobal/toMarkdown-viewer/releases/latest):
`toMarkdown.Viewer_0.6.2_x64-setup.exe` (or the `.msi`).

### Linux

Download from the
[latest release](https://github.com/carlomagnoglobal/toMarkdown-viewer/releases/latest):
`.deb`, `.AppImage`, or `.rpm`, matching your distribution.

## Building from Source


### Requirements

- Rust 1.88+ (via [rustup](https://rustup.rs/))
- Node.js 18+
- Tauri CLI: `npm install -g @tauri-apps/cli@next`

### Build

```bash
git clone https://github.com/carlomagnoglobal/toMarkdown-viewer.git
cd toMarkdown-viewer

# Install dependencies

npm install

# Build desktop app

npm run tauri build
```

Binary will be in `src-tauri/target/release/bundle/`.

## Development


### Run in dev mode

```bash
npm run tauri dev
```

### Run tests

```bash
cargo test -p to_markdown_gui
```

### Generate release bundle

```bash
npm run tauri build --release
```

## Version Compatibility


| Viewer | toMarkdownMCP |
|--------|---------------|
| 0.6.2  | ≥0.1.0        |
| 0.6.1  | ≥0.1.0        |
| 0.6.0  | ≥0.1.0        |
| 0.5.1  | ≥0.1.0        |
| 0.5.0  | ≥0.1.0        |

## Architecture


- **Backend**: Rust (Tauri 2) with SQLite vault indexing
- **Frontend**: TypeScript + HTML/CSS with vanilla JS
- **Core Dependencies**: syntect, pulldown-cmark, tauri, rusqlite

## License


MIT — See [LICENSE](./LICENSE) file.

## Contributing


Contributions welcome! Please open issues for bugs or feature requests.

## Related Projects


- [toMarkdownMCP](https://github.com/carlomagnoglobal/toMarkdownMCP) — Markdown conversion toolkit (CLI + MCP server)
- [toMarkdownMCP on crates.io](https://crates.io/crates/to_markdown_mcp)