markdown-rendering

Open markdown files in cmux right panes without blank rendering.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mrmtsuruya/hermes-backup --skill markdown-rendering-mrmtsuruya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: markdown-rendering
Source: https://github.com/mrmtsuruya/hermes-backup/tree/main/skills/markdown-rendering
Command: npx skills add https://github.com/mrmtsuruya/hermes-backup --skill markdown-rendering-mrmtsuruya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill unit solves the issue of markdown files rendering blank when opened in a cmux right pane using the 'cmux markdown open' command.

Core Features & Use Cases

  • Prevent Blank Rendering: Provides the two reliable methods to open markdown files in cmux right panes without encountering a blank-render bug.
  • Move-Surface Bug Avoidance: Instructs users to avoid using the 'move-surface' command for markdown viewers as it renders blank.
  • Use Case: When working in a cmux environment, this Skill unit is beneficial for users who need to view and edit markdown files regularly and wish to avoid the blank-rendering issue.

Quick Start

To open a markdown file without rendering issues, run the command: cmux markdown open /path/to/file.md --direction right --focus false.

Frequently Asked Questions about markdown-rendering

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why do markdown files render blank when using move-surface in cmux?▼

Markdown files render blank in cmux because the 'move-surface' command triggers a blank-render bug when applied to markdown viewers. Avoid using move-surface and use the 'cmux markdown open' command instead to display content properly in panes.

How do I open markdown files in a cmux right pane without rendering errors?▼

To open markdown files in a cmux right pane without rendering errors, run the command 'cmux markdown open /path/to/file.md --direction right --focus false' to bypass the blank-render bug and display content properly.

Can I use move-surface to reposition a markdown viewer in cmux panes?▼

No, you should not use move-surface to reposition a markdown viewer in cmux panes because it causes a blank-render bug. Use the 'cmux markdown open' command with direction parameters to position the markdown viewer correctly.

What is the best way to view and edit markdown files regularly in a cmux environment?▼

The best way to view and edit markdown files in a cmux environment is using the 'cmux markdown open' command with proper direction and focus flags, which reliably prevents the blank-rendering issue in right panes.

Does cmux markdown open support opening files in the right pane without stealing focus?▼

Yes, cmux markdown open supports opening files in the right pane without stealing focus by passing the '--focus false' flag along with '--direction right' to ensure the markdown renders correctly while maintaining your current workflow.