What is the PM file format?
A .pm file is a Perl module - a plain-text source file that packages reusable Perl code into a named namespace. The module system was introduced with Perl 5 in 1994 and remains the foundation of the CPAN ecosystem, which hosts hundreds of thousands of .pm modules.
Every .pm file declares its namespace near the top with a package statement (e.g., package HTTP::Tiny;) and conventionally ends with a bare 1; so that use or require can verify a successful load. There is no binary magic number; the file is identified by its .pm extension and the presence of a package declaration.
Module name and file path are directly linked: Foo::Bar maps to Foo/Bar.pm somewhere on Perl's @INC search path. A module is loaded by a .pl script or another module with use Module::Name; or require "Module/Name.pm".
Typical contents include:
- Exported subroutines and variables (usually managed with
Exporter) - Object-oriented class definitions
- Embedded
.poddocumentation blocks - A version declaration via
our $VERSION = '1.00';
Modules are interpreted at run time; .pmc files are an optional byte-code cache. The MIME type is text/x-perl and the encoding is usually UTF-8 or ASCII, declared with use utf8; when needed.
Security & safety
RISK: MEDIUMA .pm file is plain text and safe to read or open in an editor - it cannot act by itself. The risk is in RUNNING it: Perl modules are executable code that can read/write files, run shell commands and make network calls, and code can even run at load time (BEGIN blocks, import logic) the moment a script does 'use Module;'. So treat an untrusted .pm like any program: read it before you load it, and don't run Perl code from sources you don't trust. The file sitting on disk is harmless.
Format details
in a nutshell- Adobe PageMaker publication (.pm) - Older Aldus/Adobe PageMaker desktop-publishing documents used the .pm extension (later .pm5/.pm6/.p65/.pmd); open/convert in Adobe InDesign.
Programs that open PM files
Windows4 apps
Notepad
Open-source Open the .pm as text with Perl syntax highlighting to read or quickly edit (no execution). 
Perl (Strawberry Perl)
Open-source Install Strawberry Perl, then run a script that loads the module ('perl script.pl') or test it with 'perl -c Module.pm' to syntax-check.
Visual Studio Code (with Perl extension)
Free Open the .pm to edit with syntax highlighting and (via the Perl Navigator/Language Server) linting and go-to-definition.
Padre (legacy Perl IDE)
Open-source Old dedicated Perl IDE; usable but largely unmaintained - prefer VS Code for new work. 
macOS3 apps
Perl (built-in / Perlbrew)
Open-source macOS ships Perl; run scripts with 'perl', or use Perlbrew to manage versions. Syntax-check a module with 'perl -c Module.pm'.
Visual Studio Code (with Perl extension)
Free Edit the .pm with the Perl Navigator extension for linting and navigation. 
Linux2 apps
Perl (built-in)
Open-source Perl is preinstalled on virtually all Linux. Run scripts that 'use' the module, or 'perl -c Module.pm' to check it; 'perldoc Module.pm' reads its POD docs. Technical details
deep spec| MIME type | text/x-perl (also accepted: application/x-perl, text/plain) |
| Encoding | UTF-8 or ASCII; non-ASCII source requires an explicit `use utf8;` declaration |
| File structure | `package` declaration → imports (`use`/`require`) → subroutines and variables → optional `Exporter` setup → embedded POD docs → trailing true value (`1;`) |
| Magic bytes / signature | None; no binary signature. Identified by the `.pm` extension and a `package` statement near the top. An optional UTF-8 BOM (EF BB BF) may precede the first line. |
| Namespace-to-path mapping | Module name maps directly to its file path: `Foo::Bar` resolves to `Foo/Bar.pm` on Perl's `@INC` search path |
| Loading mechanism | Compile-time loading via `use Module;`; run-time loading via `require 'Module/Name.pm'` or `require Module::Name` |
| True-value terminator | Must end with a true value - conventionally bare `1;` - so the caller can confirm the file loaded without error |
| Version targeting | Minimum Perl version declared with `use v5.xx;` or `use 5.010;`; no file-format version of its own |
| Typical file size | 1 KB - 200 KB per module |
| Export mechanism | Subroutines and variables are selectively exposed to callers via the `Exporter` module using `@EXPORT` and `@EXPORT_OK` arrays |
| Documentation embedding | Inline Plain Old Documentation (POD) blocks, delimited by `=pod` / `=cut`; parsed by `perldoc` and POD renderers |
| Byte-code cache | Perl may store a pre-compiled form alongside the source as a `.pmc` file; the `.pm` itself is never compiled to a standalone binary |
| Obfuscation / encryption | Plain text by default; optional source filtering via modules such as `Filter::Crypto` or `Filter::Util::Call` |
| Associated platforms | Linux, macOS, Windows (Strawberry Perl / ActivePerl), and any other OS where Perl is installed |
| Released | 1987 (Perl 1.0); the .pm module convention dates to Perl 5 (1994) |
| Latest version | Perl 5.40 (2024); Perl modules remain the standard library packaging unit |
| Open standard | Yes · royalty-free |
| Specification | perldoc.perl.org |
PM conversions
Community Q&A
asked by usersNo questions yet - be the first to ask about PM files.
