I like to keep my notes in reasonable working order, but I make mistakes. It would be nice to have a pane that shows issues that Obsidian notices while parsing.
This could be shown in the file browser as a warning dot with a mouseover, for example (and propagate to the parent directory.
Things like:
Front-matter uses = instead of : and the Yaml can not be parsed right.
LaTeX throws an error (mismatching something or other).
[[other|heading]] type links where the file exists but the heading can not be found.
other things that show up. It seems like they are elegantly hidden, but Iād like to see them for all the files, so I can āclean upā (and distract myself from doing the real work).
Flag files that contain whitespace only
Flag files that are not linked to and do not contain any links
Flag dangling UIDs that are no longer referenced
Maybe: Unsupported frontmatter tags (āalasā may be a misspelling of āaliasā, then the alias is not working).
Maybe: Broken external links (http etc) to keep the brain from rotting. Maybe auto updating 308 permanent redirects, even.
This would be a nice idea, but such a facility would have to be carefully executed through a combination of selectivity and management of processing constraints
Selectivity
Some of the checks are no-brainers (weād like to know if thereās a Latex error rather than it simply not working) but some are in a gray area. For example:
I use the heading notation to represent edge types with colon as a metacharacter:
[[George#:parentof]]
in building a semantic network. The notation is benign to Obsidian; it just links to the whole note since the heading isnāt there. This allows me to do some analysis in Obsidian via graph search filters, and a lot of analysis outside of Obsidian. If we could not selectively turn on or off each check, all of my semantic network links would be flagged as an error.
Another good example:
Iāve noticed that a bunch of people in the community rely on backlinks as a form of tag or categorization:
[[recipe]] [[thyme]] [[basil]]
so that, in this example, the person can easily ask a question such as āShow me all of the recipes that can make use of basil,ā and this would be the backlink list for the note ābasilā. Yet, all of these notes are blank, and would be flagged as an error.
In a nutshell, some āerrorsā are not errors.
Management of processing constraints
The sum-total of these checks is very resource heavy, and the features could probably be separated into different contexts. For example, linting checks for āexternalā languages like Latex could be done when the note is visited. You canāt fix the problem until you visit the note, and since thereās no apparent problem until you do so, this seems to me to be the best time to check.
I try to write as simple as possible Markdown. These are my considerations:
CommonMark and GitHub Flavored Markdown (GFM) additions are inside my toolkit.
I do not to use some features like $LaTeX math$$, [^Footnotes] or [[Internal links]]. But I canāt live without #tags.
==Highlight== is great but not having an almost-standardized syntax dicourages me from using it.
After editing a note in Obsidian, I open vscode and review it using David Ansonās markdownlint extension. The default rules are usually in-sync with my ideas. Nevertheless, itās possible to tweak some of them or disable any that I donāt wish to follow.
I hope my experience is useful to make the decision. But itās a hard one because of the different Markdown tastes Obsidian supports.
I think this feature of āConfigurable markdown lintingā would be very useful. Iām writing a lot of technical documentation in VS Code with markdownlint extension, so Iām used to just pressing āSaveā and seeing everything nicely formatted, especially tables.
In the meantime I will configure a script to run markdownlint on my vault, but it would have been so nice to have it built-in.
