I Just Want to "Take a Quick Look"

Most of the time, when I open a Markdown file, I'm not trying to edit it.

I just want to quickly see what's inside.

For example:

  • A GitHub project's README
  • A technical document I just pulled down
  • A specification file from a colleague
  • Notes I organized previously

But on Windows, double-clicking a .md file usually launches VS Code.

The problem isn't that VS Code is bad—it's that it's too "heavy."

Startup, loading plugins, restoring the workspace—by the time all that's done, several seconds have passed.

If you're only looking at content for a few dozen seconds, that wait feels unnecessary.

Over time, this "meaningless waiting" becomes quite noticeable.

I Tried Many Existing Tools

I later went looking for existing solutions. They roughly fall into a few categories:

Typora

The experience is indeed great, and reading is comfortable.

But at its core, it's still an editor, not a pure reading tool.

And since it's now paid software, using it just to "view files" feels heavy.

Obsidian

Very powerful, with excellent knowledge management.

But its positioning is a "personal knowledge base system," not "open and view."

Opening a temporary Markdown file feels like overkill.

Other Open-Source Markdown Editors

Tools like MarkText are decent too, but they generally share a few traits:

  • More focused on editing than reading
  • Electron-based, so the file size is large
  • Startup speed is mediocre

For "open → glance → close," they're not lightweight enough.

Online Markdown Preview

There are plenty of online tools too.

But the problems are very real:

  • Requires copy-pasting
  • Local images often break
  • Privacy-sensitive content is uncomfortable to upload

For frequent daily viewing, they're not convenient enough.

The Core Problem Is Actually Very Simple

Eventually I realized:

Most Markdown tools on the market are doing "editor enhancement," not "reading experience optimization."

Everyone is building:

  • Knowledge bases
  • AI writing
  • Plugin systems
  • Cloud sync
  • Collaborative editing

But very few seriously address the most basic problem:

Just wanting to quickly open and read a Markdown file.

And this need is actually very frequent.

So I Built a Lighter Tool: mdview

So I built a tool myself—mdview.

Its goal is simple:

Make opening Markdown on Windows as direct as opening an image.

No complex concepts, no unnecessary features.

Just "open → read → close."

It Does Very Little, But Very Focused

Double-Click to Open .md Files

After installation, it can directly associate Markdown files.

From then on, double-clicking .md opens the reading view, without launching an editor.

The entire program is only about 1.6 MB, and startup is virtually instantaneous.

Auto-Refresh Content

If you're simultaneously editing the file in VS Code or Cursor, the reading window auto-updates after you save.

No manual refresh needed, no reopening required.

Auto Table of Contents Navigation

For longer Markdown documents, a table of contents is automatically generated.

Click headings to jump—very handy for READMEs and technical docs.

Essential Reading Features Are All There

For example:

  • Dark / light mode
  • Local images display correctly
  • Ctrl + scroll to zoom
  • PDF export
  • Ctrl + E to jump to editor position

These are all basic capabilities built around the "reading experience," with no extra complex configuration.

Fully Local

All content is rendered locally.

No account needed, no file uploads.

For company documents or personal notes, this provides more peace of mind.

I Deliberately Removed Many "Cool-Looking" Features

During development, the most common thing I did wasn't adding features—it was removing them.

For example:

  • Cloud sync
  • AI assistant
  • Plugin system
  • Workspace management
  • Online collaboration

None of these were added.

The reason is simple: they don't belong to the act of "reading Markdown" itself.

I wanted it to be more like Windows' built-in image viewer:

Open the file, see the content directly, close when done.

In Closing

If your use case is similar to mine:

  • Frequently reading GitHub READMEs
  • Often opening Markdown documents
  • Don't want to launch VS Code every time
  • Want a lightweight reading tool

Give mdview a try.

It doesn't do much, but its goal is clear: only do Markdown reading.

If it happens to save you those few seconds of startup time, then the tool has served its purpose.