{
  "markdown": "<p align=\"center\">\n  <img src=\"./extras/arto-header-readme.png\" alt=\"Arto\" />\n</p>\n\n**Arto — the Art of Reading Markdown.**\n\nA local app that faithfully recreates GitHub-style Markdown rendering for a beautiful reading experience.\n\n## Philosophy\n\nMarkdown has become more than a lightweight markup language — it's the medium for documentation, communication, and thinking in the developer's world. While most tools focus on _writing_ Markdown, **Arto is designed for _reading_ it beautifully**.\n\nThe name \"Arto\" comes from \"Art of Reading\" — reflecting the philosophy that reading Markdown is not just a utility task, but a quiet, deliberate act of understanding and appreciation.\n\nArto faithfully reproduces GitHub's Markdown rendering in a local, offline environment, offering a calm and precise reading experience with thoughtful typography and balanced whitespace.\n\n> [!WARNING]\n> **Beta Software Notice**\n>\n> - This application is still in **beta** and may contain bugs or unstable behavior. Features may change without regard to backward compatibility.\n> - **macOS Only**: This application is currently designed exclusively for macOS and does not support other platforms. However, cross-platform support is a long-term goal, and **PRs are welcome**.\n\n## Features\n\n### Core Reading Experience\n\n- **GitHub-Style Rendering** — Accurate reproduction of GitHub's Markdown styling with full support for extended syntax\n- **Native Performance** — Built with Rust for fast, responsive rendering\n- **Auto-Reload** — Automatically updates when the file changes on disk\n- **Offline First** — No internet connection required — read your docs anytime, anywhere\n\n### Navigation & Organization\n\n- **File Explorer** — Built-in sidebar with file tree navigation for browsing local directories\n- **Quick Access** — Bookmark frequently used files and directories for instant access\n- **Directory History** — Back/forward navigation within the sidebar file explorer\n- **Table of Contents** — Automatic TOC panel for easy document navigation\n- **Live Navigation** — Navigate between linked markdown documents with history support (back/forward)\n\n### Search & Discovery\n\n- **Find in Page** — Search within documents with `Cmd+F`\n- **Pinned Search** — Pin search queries with persistent multi-color highlighting across sessions\n\n### Window & Tab Management\n\n- **Tab Support** — Open and manage multiple documents in tabs within a single window\n- **Multi-Window** — Create multiple windows and open child windows for diagrams\n- **Cross-Window Tabs** — Drag and drop tabs between windows\n- **Drag & Drop** — Simply drag markdown files onto the window to open them\n\n### Advanced Rendering\n\n- **Mermaid Diagrams** — Interactive diagram viewer with zoom, pan, and copy-as-image\n- **Math Expressions** — Beautiful KaTeX rendering for mathematical notation\n- **Code Highlighting** — Syntax highlighting with copy button for code blocks\n- **Frontmatter** — Renders YAML frontmatter as a styled, collapsible table\n- **GitHub Alerts** — Full support for NOTE, TIP, IMPORTANT, WARNING, and CAUTION alerts\n\n### Customization\n\n- **Dark Mode** — Manual and automatic theme switching based on system preferences\n- **Zoom Controls** — Keyboard shortcuts and trackpad gestures for zoom\n- **Preferences** — Configurable settings for sidebar, TOC, and more\n- **Context Menus** — Right-click menus for quick actions on files and content\n\n### Keyboard Shortcuts\n\nShortcuts are stored in `mappings.json` (next to `config.json` in the app config\ndirectory) and come in two kinds:\n\n- **Menu shortcuts** (`menuShortcuts`) — native OS menu accelerators. Single\n  chord only (e.g. `Cmd+o`), shown in the menu bar, dispatched by the system, so\n  they work even when no window has keyboard focus (e.g. `Cmd+n` with all windows\n  closed). Keyed by a menu action such as `file.open`.\n- **Keybindings** (`global` and the per-context sections) — handled by the\n  in-window engine. Support chord sequences (e.g. vim `g g`) and per-context\n  behavior, but only fire while a document window has focus.\n\nThe same action may appear in both — for example `file.open` can be a native\n`Cmd+o` menu shortcut and additionally have an in-window keybinding.\n\n**Migrating an older `mappings.json`:** files written before `menuShortcuts`\nexisted still load unchanged. Menu-backed shortcuts you had under `global`\n(e.g. `Cmd+o`, `Cmd+n`) keep working via the engine, but to get native menu\naccelerators move those entries into a `menuShortcuts` section, or re-apply a\npreset (Default / Vim / Emacs) from Preferences.\n\n### macOS Integration\n\n- **Quick Look** — Press Space on any Markdown file in Finder to get a rendered preview\n- **Finder Preview Pane** — Markdown files display rendered HTML in the Finder sidebar preview pane\n\n## Installation\n\n### macOS\n\nUse [Homebrew] tap to install. Since the application is not signed or notarized with an Apple Developer ID, you'll need to remove the quarantine attribute after installation.\nSee [homebrew-tap] for more information.\n\n```\nbrew install --cask arto-app/tap/arto\nxattr -dr com.apple.quarantine /Applications/Arto.app\n```\n\n> [!TIP]\n> **Quick Look preview not showing?** macOS normally registers the Quick Look\n> extension the first time you launch Arto. If pressing Space on a Markdown file\n> still shows no preview — or a stale one right after an upgrade — register the\n> extension manually and refresh the cache:\n>\n> ```sh\n> pluginkit -a /Applications/Arto.app/Contents/PlugIns/ArtoQuickLook.appex\n> qlmanage -r && qlmanage -r cache\n> ```\n\n### Linux\n\nOn Debian and Ubuntu, download the `.deb` matching your architecture from the\n[releases] page and install it with `apt`, which pulls in the GTK/WebKit\nlibraries it declares:\n\n```\nsudo apt install ./arto_<version>_amd64.deb\n```\n\nOn every other distribution — Fedora, openSUSE, Arch — download the\n`.AppImage` instead, make it executable and run it:\n\n```\nchmod +x arto_<version>_x86_64.AppImage\n./arto_<version>_x86_64.AppImage\n```\n\nThe AppImage needs WebKitGTK 4.1 present on the system; on Fedora that is\n`sudo dnf install webkit2gtk4.1`.\n\nBoth artifacts are built on Ubuntu 24.04, so they require glibc 2.39 or newer\n(Ubuntu 24.04+, Debian 13+, Fedora 40+). On older distributions, build from\nsource or use the Nix package below.\n\n### Nix\n\n[Nix] is supported on both macOS and Linux.\nTo try it without a permanent installation:\n\n```\nnix run github:arto-app/Arto\n```\n\nFor a permanent installation, use [nix-darwin] or [home-manager].\nAdd the following to your flake inputs:\n\n```nix\narto.url = \"github:arto-app/Arto\";\n```\n\nThen add it to `environment.systemPackages` (nix-darwin) or `home.packages` (home-manager):\n\n```nix\nenvironment.systemPackages = [ inputs.arto.packages.${system}.default ];\n```\n\nLaunch the application to see the welcome screen with keyboard shortcuts and usage instructions.\n\n## Usage\n\nAfter installation, the `arto` command becomes available in your terminal:\n\n```\narto                     # Launch Arto (shows welcome screen)\narto README.md           # Open a specific file\narto --open=screen README.md\narto --open=new README.md\narto --directory=. README.md\narto docs/               # Open a directory in the file explorer\narto file1.md file2.md   # Open multiple files in tabs\n```\n\nArto runs as a **single instance** — if Arto is already running, the command sends requests to the existing process instead of launching a new one.\n\n- `arto FILE` uses `last_focused` behavior by default (reuse last focused visible window).\n- `--open=screen` opens on/reuses a visible window on the cursor's current screen.\n- `--open=new` always opens in a new window.\n- `--directory=DIR` sets the FileExplorer root directory for that invocation.\n- Positional directory arguments (e.g. `arto docs/`) also set the root directory.\n- Running `arto` without arguments shows/focuses an existing window if hidden, or opens one if none exists.\n\n[Homebrew]: https://brew.sh/\n[homebrew-tap]: https://github.com/arto-app/homebrew-tap\n[releases]: https://github.com/arto-app/Arto/releases\n[Nix]: https://nixos.org/\n[nix-darwin]: https://github.com/nix-darwin/nix-darwin\n[home-manager]: https://github.com/nix-community/home-manager\n\n## Official Website\n\nVisit [arto-app.github.io](https://arto-app.github.io) for screenshots, feature highlights, and more.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.\n\n## License\n\nSee [LICENSE](LICENSE) file for details.\n",
  "bytes": 8441,
  "sha": "362b961581e4d021ec403ee9372bb4db7a7deb0524165fe902987a381bae090c",
  "repo_slug": "lambdalisue/rs-arto",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_lambdalisue_rs_arto_design_add_icon_main_b0408b40/readme"
}