Debugging

Debug Mode

You can enable debug logging by opening Marked Settings, Advanced pane and checking the Debug Mode checkbox at the bottom of the pane. This will display a dropdown menu where you can set the level of logging you’d like to see:

  • Errors only: Only severe errors will be logged
  • Errors and Warnings: Additionally display less urgent warnings
  • All: Display errors, warnings, and info-level debug messages. This is the recommended setting for troubleshooting.

You can also access these options by holding the key when opening Help in the menu bar.

Viewing the log

With Debug Mode enabled, you can open the Help menu and select Open Debug Log. This will open Marked’s log in Console.app, which will be updated live as log messages are added while using Marked.

Troubleshooting Custom Processors

Custom preprocessors and processors get their own log interface. Select Help Show Custom Processor Log to open the window. This window has two tabs, one for the Processor and one for the Preprocessor.

Custom Processor Log
Custom Processor Log

Each tab shows two panes, one for STDOUT, and one for STDERR. When creating a Custom Processor, you can log messages to STDERR to assist with debugging. Messages will be shown in this window, but will have no effect on the output shown in the Preview.

Reporting an Issue

Use Help Report an Issue to open a window that shows your settings for the most common keys, and a template for creating a bug report. Use the “Copy to Clipboard” button to copy the contents of the window, and click “Open Support Site” to be taken to a page where you can paste your report and create a new issue. I try to respond to reports within 48 hours.

Next up: Additional Help


Search | Support Site | Knowledgebase | Legal | Privacy | Twitter