In short:
ak-markdown-novel-vieweropens a markdown file or folder (an RFC, a runbook, a report, a plan) in a book-like reader running on your machine, and returns the exact URL the server prints. When you are done, it only stops the server it started itself. It does not make an HTML file to send around: that isak-preview --html.
Disclosure: I maintain AgentKit and have an affiliate relationship with it: the AgentKit link in this post is an affiliate link; buying through it gets you 30% off.
Summary
Use it when you have a long markdown document, a folder of documents, or a multi-phase plan and want to read it in a browser instead of scrolling in the terminal. You do not need it when you want a standalone HTML file to send to someone else.
flowchart LR
A["Markdown file or folder"] --> B["ak-markdown-novel-viewer"]
B --> C["Reader URL on localhost"]
C --> D["You read in the browser"]
D --> E["Stop this run's server"]
A -.->|"Need a standalone HTML file"| F["ak-preview --html"]Four concepts to know:
| Concept | Question | Example |
|---|---|---|
| File or folder | What do you give it? | docs/rfc-042.md opens the reader directly; docs/ opens a list of files and subfolders |
| Plan folder | When does the reader get a sidebar and Previous, Next buttons? | Open plan.md in a folder with phase files: the sidebar lists the phases with their status |
| Real URL, no port guessing | Which address does the page open at? | If port 3456 is busy the server moves to the next free port; the skill returns the exact URL the server prints |
| Whoever starts a server stops it | Who stops the server, and which one? | The skill records the PID, port and project of the server it started and stops only that PID |
By default the server only listens on localhost; to open it from a phone or another machine on the same network, say so in the prompt.
Sample prompt for reading a long document:
/ak-markdown-novel-viewer docs/<document name>.mdThis skill has no flags. Below is the detailed version: the run flow, 5 situations with prompts, the change history by ak release, and common pitfalls. The detailed version and the interactive page are for subscribers. Your agent can also search them through the portal's MCP.
Opens when your account has subscriber access
This guide is for subscribers
Once your account has access, the full piece, the interactive visual and the agent call all open.
- Sign in or create a modernEngineer accountReading access belongs to your account email.
- Choose a plan on the pricing page1, 3 or 12 months, paid by VietQR bank transfer. Access opens about a minute after the money arrives.
- Or redeem a Facebook subscriber codePeople supporting the page on Facebook get an activation code by message each month.
Already a subscriber? Sign in to read.
Use this piece in your agent
Get an API keyCopy the text below and paste it into Claude Code, Codex or whichever agent you use. The agent reads the piece and checks it against the repo you have open.
Read "ak-markdown-novel-viewer: read long markdown in a book-like page" on modernEngineer and apply it to this repo.
1. Call the content_get tool of the modernengineer MCP server with locale "en", slug "ak-markdown-novel-viewer". If the modernengineer MCP server is not connected, stop and walk me through connecting it from https://modernengineer.dev/en/mcp.
2. Summarize the main steps of the piece and point out which apply to this repo.
3. Propose concrete changes and ask me before editing any file.Connect MCP in Claude Code (once)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Reading the full piece over MCP needs an API key from a subscriber account or one that bought this guide. Without access, the agent only gets the opening.
- Version
- v1.0.0
- Updated
- 22/10/2026
- Licence
- All rights reserved
- Slug
- ak-markdown-novel-viewer
