manpage adds syntax highlighting for Unix/Linux manual pages (roff/man macros) in Visual Studio Code. It helps you read and edit .man, .manpage, and section files (.1–.8) with clearer structure for titles, headings, macros, and comments.
See docs/QUICKSTART.md for a one-minute install-and-try path.
From the Marketplace
- Open VS Code Quick Open (
Ctrl+P/Cmd+P). - Paste and run:
ext install CompilouIT.manpageOr install from the Visual Studio Marketplace.
From source (development)
git clone https://github.com/jmurowaniecki/manpages.git
cd manpages
npm installThen open the folder in VS Code (File → Open Folder) and press F5 to launch an Extension Development Host, or symlink/copy the repo into your VS Code extensions directory.
Open any man-page source file (for example foo.1 or bar.man). VS Code should select the manpage language automatically from the file extension. You can also choose manpage from the language mode picker in the status bar.
File associations, language configuration, and TextMate scopes are documented in docs/INTERFACE.md.
- Bugs and enhancements: GitHub Issues
- Pull requests: see CONTRIBUTING.md
- Security reports: see SECURITY.md
- Code of Conduct: CODE_OF_CONDUCT.md
- Governance: GOVERNANCE.md
| Doc | Purpose |
|---|---|
| docs/QUICKSTART.md | Fast path for new users |
| docs/INTERFACE.md | External interface (extensions, scopes) |
| docs/ARCHITECTURE.md | High-level design |
| docs/ROADMAP.md | Plans for the next year |
| docs/ASSURANCE-CASE.md | Security requirements and threat model |
| docs/SIGNED-RELEASES.md | How to verify releases |
- OpenSSF Best Practices (badge above; update status on the site as criteria are met)
This extension only provides TextMate grammar and language configuration for editor highlighting. It does not execute man-page content, run shell commands, or contact the network. Treat untrusted .man files like any other untrusted text: open them only when you intend to review or edit them.
See CHANGELOG.md for release notes.
- How To – Linux / UNIX Create a Manpage
- Creating Your Own MAN Page Version 1.0
- Create man page in Linux with examples
- How to create your own man pages
Licensed under the MIT License.