~/.unplanned
April 11th, 2025

Deft, Markdown, Marksman/Emacs LSP, iA Writer

Tools

This is probably one of those "IYKYK" kind of posts, because the thought of making the title of this post meaningful to anyone it is not already meaningful to is pretty daunting. So I guess I'll forgive myself and imagine an audience of three or four people for this:

Marksman is an LSP server that offers coding assistance for Markdown in a variety of editors. Coding assistance for Markdown seems like an odd thing, but Marksman does an okay job of autogenerating ToCs for Markdown docs, and it can autocomplete potential wikilink completions if you just start typing "[[" to make a Markdown wiki link. 

One configuration thing to get this to work correctly, and if you tend to lead Markdown documents with a level 1 heading: 

[core]
title_from_heading = false

That needs to go in the .marksman.toml file Marksman looks for in the root of a given project directory.

If you do that, though, you  end up with autocompleted wikilinks that are cross-compatible between Emacs' markdown mode and iA Writer on Mac or iOS/iPadOS.

No, it's not Denote, org-roam, or anything else like that and I think I am pretty okay with that. I still like org-mode for my plaintext todos and Journelly, but for day-to-day writing tasks I prefer Markdown and its more expansive ecosystem. It's not Obsidian, either, and that is really okay ...

Mad Max: That's bait

I guess one other thing: The LSP doesn't always fire up when I open up a Markdown file, so I added this to my Doom config:

\#+begin_src emacs-lisp
(use-package! markdown-mode
  :hook (markdown-mode . lsp!)
  :config
  (require 'lsp-marksman))
\#+end_src