mrkeyoor.com_
Mon 14 Sept 13:31 UTC
Dev Toolsevaluationupdated 14 Sept 2026

marktext review

MarkText is a free desktop Markdown editor that shows formatted text as you write while keeping the document as a normal local `.md` file. It runs on Linux, macOS, and Windows, with source, focus, and typewriter modes for people who want a calmer alternative to a code editor.

trackingstars / 7d
Verdict

Our MarkText install took 138 seconds and 1,735 MB, and 815 of 818 tests passed before 3 PDF tests failed, so the app is easier to recommend as a downloaded editor than as a low-friction source dependency. Use it for focused work on local Markdown files when inline formatting matters more than notebooks, sync, or collaboration. Choose a different tool if unsigned macOS binaries or a failing source test baseline are unacceptable.

We ran it

Lab card: what happened when we ran marktextScreenshot of marktext (www.marktext.me)
Install✓ · 138s1857 packages · 1735 MB
Build✓ · 43s
Tests✗ · 31s815 passed · 3 failed of 818 (vitest)
Repo1911 files~175,838 lines of source · 34.4 MB · 14 CI workflows

Answers from our run

Does marktext build from source?

Dependencies installed in 138 seconds (1857 packages), and the build succeeded in 43 seconds. We cloned commit c2d150f into a clean Debian container with 3 CPUs and no project-specific setup.

Do marktext's tests pass?

Not all of them: 815 of 818 passed and 3 failed when we ran the project's own test command (vitest). Some failures need services or credentials a bare container does not have.

Who should not use marktext?

Note collectors who need backlinks, tags, mobile sync, or a knowledge graph: MarkText's FAQ calls it a pure Markdown editor and says it has no knowledge-management or tagging features.

What are the alternatives to marktext?

Zettlr, Joplin, HedgeDoc. Our MarkText install took 138 seconds and 1,735 MB, and 815 of 818 tests passed before 3 PDF tests failed, so the app is easier to recommend as a downloaded editor than as a low-friction source dependency.

Setup3/5Prebuilt apps are simple; source install used 1,735 MB and tests failed
Docs4/5User and build guides cover platforms, export, settings, and fixes
Community5/561,396 stars, a same-day push, and quick issue fixes
Maturity4/5v0.19.1 spans 3 platforms, but macOS builds are unsigned

Who it’s for

Writers who want a visual editor while keeping ordinary Markdown files they can move, diff, and archive.
Developers maintaining README files, documentation, or blog posts with CommonMark and GitHub Flavored Markdown.
Desktop users who need math, front matter, themes, and PDF or HTML export without a hosted writing service.
People who switch between a formatted view and source code but do not want a full programming editor open all day.

Who it’s NOT for

Note collectors who need backlinks, tags, mobile sync, or a knowledge graph: MarkText's FAQ calls it a pure Markdown editor and says it has no knowledge-management or tagging features.
Mac users whose security policy forbids unsigned software or manual Gatekeeper exceptions: v0.19.1 is unsigned, and its release notes instruct users to clear the app's quarantine flag.
Contributors looking for a small Node project with a clean baseline: our install added 1,857 packages and used 1,735 MB, while 3 of 818 tests failed.
Linux users who cannot change user-namespace or SUID sandbox settings: the FAQ lists those changes, or --no-sandbox, when Chromium's sandbox will not start.
Authors who require complete Pandoc compatibility or Word export: the README promises selective Pandoc support and lists HTML and PDF as the export formats.

Setup reality

Our sandbox install at commit c2d150f succeeded in 138 seconds, adding 1,857 packages and using 1,735 MB. The build succeeded in 43 seconds. Tests then failed after 31 seconds: Vitest passed 815 of 818 tests, while the PDF test file reported 3 failures and timeout errors at 5,000 ms.

The prebuilt app path lists no account, credential, or external service. Building needs Node.js 20.19.0 or newer, pnpm 10 or newer, Python 3.12 or newer, C++ tooling, and native libraries; the Linux guide names X11, xkbfile, libsecret, fontconfig, and rpm packages.

Runtime details vary by platform. macOS 11 or newer builds are not signed or notarized, and the v0.19.1 release tells users to clear quarantine. On Linux, the FAQ says Chromium may need user namespaces, a correctly permissioned SUID helper, or --no-sandbox if the sandbox cannot start.

MarkText v0.19.1 edits local files on three desktop systems

MarkText is an MIT-licensed desktop editor for people who like Markdown's portable files but dislike writing every marker by hand. The v0.19.1 app runs on Linux, macOS, and Windows. Its formatted view updates as you type, while source mode exposes the text. There is no proprietary document format, making it a practical front end for notes, READMEs, and articles stored in folders or Git.

The MarkText README lists CommonMark, GitHub Flavored Markdown, and selective Pandoc syntax support. Math uses KaTeX, while front matter and emoji extensions cover common publishing needs. Focus and typewriter modes reduce visual noise. HTML and PDF export are built in, and the export guide adds page size, margins, themes, headers, and footers. Page numbering is still unsupported.

The editor has 35 encodings but no knowledge graph

MarkText's settings go deeper than its spare interface. The current preferences reference lists 35 text encodings, configurable line endings, folder search exclusions, image paths, custom CSS, and polling for network shares. You can paste images, choose relative asset folders, set an editor width, and enable footnotes or superscript syntax. These controls help when Markdown files must survive several operating systems or publishing tools.

MarkText's FAQ calls it a pure Markdown editor without knowledge management or tags. It has a filesystem explorer and task lists, but does not replace a synced notebook or linked-note database. That restraint works if folders already provide structure. People seeking backlinks, mobile capture, shared notebooks, or a graph view should use a notes app built around those jobs.

What happened when we ran it

Our sandbox installed commit c2d150f in 138 seconds. Pnpm added 1,857 packages and left 1,735 MB on disk, then the build succeeded in 43 seconds. The checkout contained 1,911 files, about 175,838 lines of source, and occupied 34.4 MB. This workspace monorepo had 14 CI workflow files, no Dockerfile, and no top-level tests directory.

The test command failed with exit code 1 after 31 seconds. Vitest passed 815 tests and failed 3 out of 818, with 58 test files passing and 1 failing. All 3 failures were in test/unit/specs/pdf.spec.ts; the log tail showed 5,000 ms timeout errors. It did not show why they exceeded the limit, so we cannot label the failure a missing package, product defect, or slow-container problem. The result applies to our test method and this commit.

A source build needs Node.js 20.19.0 and native Linux packages

The build guide requires Node.js 20.19.0 or newer, pnpm 10 or newer, Python 3.12 or newer, and C++ build tools. Linux contributors also need headers for X11, xkbfile, libsecret, and fontconfig; Debian packaging adds rpm. Its container example uses Node 22 Bookworm and installs those packages before pnpm install, so the two-command recap on the installation page is the short version.

End users can avoid source setup by downloading a release. MarkText v0.19.1 ships x64 and Arm installers or archives, including 5 Linux package formats. Windows gets setup and portable builds; Linux gets AppImage, deb, rpm, snap, and tar.gz choices. The installation guide says portable Windows and Linux AppImage installs do not update themselves, so those users must fetch later releases manually.

The v0.19.1 macOS release is unsigned

Mac users face a security-policy decision before the first document opens. The v0.19.1 release notes say its macOS builds have no Apple Developer ID signature and tell users to clear quarantine after copying the app to Applications. The installation page describes the builds as not notarized and suggests approval through Gatekeeper. A personal Mac can accept that exception, but many managed workplaces will refuse it.

If Chromium's SUID sandbox cannot start on Linux, the FAQ gives 3 remedies: enable unprivileged user namespaces, set root ownership and mode 4755 on the sandbox helper, or launch with --no-sandbox. The last choice weakens process isolation, while the first two require system control. A locked-down workstation may need administrator help even when the AppImage downloads and opens without package installation.

The September 14 push fixed 2 footnote reports within hours

GitHub recorded 61,396 stars, 545 combined issues and pull requests, and a last push on September 14, 2026. Raw totals do not show response quality, but that day's history does. Issue 5340 reported that Backspace inside a nested footnote could break later edits; issue 5343 described an empty definition. Pull request 5347 added regression tests and closed both less than 2 hours after the first report opened.

That September 14 commit, c2d150f, is the one our sandbox tested. The quick footnote response and 14 CI workflow files show active engineering, while 3 failing PDF tests leave an unclean baseline on our box. A stale stable tag would tell the wrong story: v0.19.1 shipped on June 6, 2026, yet code and issue work continued on this review's date. Maintenance is current even though the release and source experiences carry different risks.

Pick MarkText for file editing and Joplin for a note library

MarkText v0.19.1 fits when the unit of work is one local Markdown file and the desired upgrade is visual editing. Zettlr is better suited to academic citations, Pandoc publishing, and Zettelkasten workflows. Joplin supplies notebooks, tags, mobile apps, plugins, and encrypted sync. HedgeDoc moves editing into a shared browser session for teams.

Our 138-second install and 1,735 MB dependency footprint should not stop a writer from trying a prebuilt MarkText package. They should make a contributor budget time for the source tree and reproduce the 3 PDF failures before changing export code. MarkText is a good fit when local files, inline formatting, and a quiet screen are enough. Sync, collaboration, citations, or institutional Mac approval each make an alternative easier to live with.

Alternatives

ProjectWhat it isPick it when
ZettlrA Markdown publication workbench with citations, Pandoc export, and Zettelkasten features.pick this instead when research citations, Word or LaTeX output, and a searchable knowledge system matter more than MarkText's minimal editing surface.
Joplin gh↗An offline-first Markdown notebook with tags, mobile apps, plugins, and encrypted sync.pick this instead when you need one note library across desktop and mobile devices, with search and synchronization built in.
HedgeDocA self-hosted web editor for collaborative Markdown notes.pick this instead when several people need to edit the same document in a browser at the same time.

What people are saying

  1. [velocity-scout] marktext/marktext

Sources

  1. MarkText README and feature list
  2. MarkText build instructions
  3. MarkText installation guide
  4. MarkText v0.19.1 release
  5. MarkText FAQ
  6. Footnote fix pull request 5347

More dev tools reviews

happy · OCRmyPDF · sharp · Kingfisher · mypy · act · the whole board →