|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|Marksman||1,001||4 days ago||1||March 26, 2022||45||mit||F#|
|Write Markdown with code assist and intelligence in the comfort of your favourite editor.|
|Emfy||854||10 months ago||1||mit||Emacs Lisp|
|A dark and sleek Emacs setup for general purpose editing and programming|
|Ox Hugo||800||7 days ago||26||gpl-3.0||Emacs Lisp|
|A carefully crafted Org exporter back-end for Hugo|
|Markdown Mode||796||2 days ago||113||gpl-3.0||Emacs Lisp|
|Emacs Markdown Mode|
|Markdownfmt||732||5||a year ago||June 23, 2014||16||mit||Go|
|Like gofmt, but for Markdown.|
|Khoj||494||a day ago||26||gpl-3.0||Python|
|An AI personal assistant for your digital brain 🦅|
|Poet||393||3 years ago||4||mit||Emacs Lisp|
|An emacs theme that's well suited for modes using variable pitch: particularly org-mode and markdown-mode.|
|Emacs Easy Hugo||305||3 months ago||1||gpl-3.0||Emacs Lisp|
|Emacs major mode for managing hugo|
|Md Roam||270||3 months ago||4||gpl-3.0||Emacs Lisp|
|Use Org-roam with markdown files by adding Md-roam as a plug-in. Mix org and markdown files in a single Org-roam database.|
|Toc Org||225||a year ago||6||gpl-3.0||Emacs Lisp|
|toc-org is an Emacs utility to have an up-to-date table of contents in the org files without exporting (useful primarily for readme files on GitHub)|
Write Markdown with code assist and intelligence in the comfort of your favourite editor.
Marksman is a program that integrates with your editor to assist you in writing and maintaining your Markdown documents. Using LSP protocol it provides completion, goto definition, find references, rename refactoring, diagnostics, and more. In addition to regular Markdown, it also supports wiki-link-style references that enable Zettelkasten-like[^roam-research], [^markdown-memo] note taking. See more about Marksman's features below.
Marksman works on MacOS, Linux, and Windows and is distributed as a self-contained binary for each OS.
The server provides assistance with:
This is [inline link](/some-file.md#some-heading). This is an internal [anchor link](#heading).
See [reference]. [reference]: /url "Title"
Link to [[another-note]]. Link to [[another-notes#heading]]. Internal link to [[#a-heading]].
All types of links support completion, hover, goto definition/references. Additionally, Marksman provides diagnostics for wiki-links to detect broken references and duplicate/ambiguous headings.
via LSP Mode (automatic server installation).
Example config for
(use-package markdown-mode :hook (markdown-mode . lsp) :config (require 'lsp-marksman))
via Eglot, requires configuration (unless
eglot#1013 gets merged); add the following to your
(add-to-list 'eglot-server-programs '(markdown-mode . ("marksman"))) (add-hook 'markdown-mode-hook #'eglot-ensure)
marksmanbinary to your
See the installation instructions.
See the Features page to learn more about language features, configurations, and single- and multi-file modes.
.marksman.tomlin the root folder of your project or initialize a repository (e.g.
git init). See this page to learn more about single- and mult-file modes.
xattr -d com.apple.quarantine <path-to-marksman-bin>.
[^roam-research]: You may have heard about Roam Research. That is a commercial implementation of the Zettelkasten method and another point of reference for what Marksman is about. However, unlike a proprietary Roam Research, Marksman is free, open-source and integrated into your favourite editor (albeit for not not as feature rich as Roam Research).
[^markdown-memo]: There is an excellent VSCode extension called Markdown Memo. You definitely need to check it out if you're primarily using VSCode as it has some features that are missing in Marksman and Marksman VSCode extension. However, Markdown Memo is VSCode specific while Marksman is a generic language server, so can be used with any editor that has LSP support: Emacs, Vim, Neovim, etc.
[^lsp]: Since Marksman is a regular Language Server most of the functionality works out of the box with any LSP client.
[^single-file-mode]: There is an initiative to add a single-file mode to LSP but it's not a part of the spec at least until and including v3.17.