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.