Frequently Asked Questions
- License code has already been utilized
- Site licenses and educational discounts
- A URL won’t validate or returns “Unknown”
- Custom processor permissions in MAS version
- Intra-document links in exported PDFs
- Relative paths in included files
- How do I retrieve a lost license (direct version)
- In-app purchase issues (Error Domain=Paddle Code=0 “(null)”)
- Fenced code blocks inside indented code blocks
License code has already been utilized
If you do a fresh install of Marked 2 and receive the error “License code has already been utilized” when entering your license, please contact me requesting a new license. Please include the email address you registered under and/or your current license code.
Early licenses generated for Marked had a usage limit instead of a machine limit, so 3 installs—even on the same machine—would use up activations. These limits have been corrected in more recently-generated licenses. Purchase of a Marked 2 license permits you to install Marked 2 on any machine you own, so don’t hesitate to ask for a replacement if you run into issues.
Site licenses and educational discounts
Discounted site/bulk licenses are available for Marked 2. To request a purchase link, please contact Brett and specify the number of licenses you’d like to purchase.
- 5–9: 10% off
- 10–19: 12% off
- 20–49: 15% off
- 50+: 20% off
An educational discount is also available for both the direct and Mac App Store versions. For the Mac App Store, standard Apple educational discounts are enabled. To purchase a direct version with an educational discount, contact me and request a coupon.
A URL won’t validate or returns “Unknown”
Marked’s link validation uses a basic HEAD request to determine whether a link is valid. Anything other than a 200 (success) result will give either an unknown, or an error if it’s a common error code such as 404 (not found) or 500 (server error). URLs behind authentication (such as Apple Developer urls or anything that requires login to access) will return an “unknown”, as will certain sites such as Amazon.com where the server returns bizarre response codes. There’s not much Marked can do about this.
Custom processor permissions in MAS version
Due to sandboxing restrictions, the Mac App Store version of Marked 2 is unable to execute certain types of binary tools as custom processors. If you run into this limitation, there are a few steps you can try.
Ensure that you’ve gone into Marked 2 Preferences (⌘,), in the Advanced pane and clicked on “Update Permissions.” This will attempt to grant Marked access to your entire default drive, clearing up issues with scripts and utilities that need to access temp folders and non-default locations.
Try using a script. Reference the utility you want to run (multimarkdown, kramdown, etc.) in a shell script. It can be a bash, Ruby, Perl, or Python script. Then set the processor in Advanced preferences to the related shell or executable, and the parameters to the location of the script. For example, I can create a bash script saved to ~/scripts/mmd_wrapper.sh:
#!/bin/bash cat | /usr/local/bin/multimarkdown
Then make it executable (
chmod a+x ~/scripts/mmd_wrapper.sh) and set up my Custom Processor preferences:
Processor: /bin/bash Arguments: /Users/me/scripts/mmd_wrapper.sh
Some executables (especially Pandoc) just won’t work within sandboxing. In this case, please contact me via the error window that pops up upon execution to receive a crossgrade license to the direct version.
Intra-document links in exported PDFs
Marked’s PDF export currently uses WebKit’s print features. One consequence of this is that intra-document (internal) links, including those in a Table of Contents, will not jump to other points in the document. This doesn’t appear to be something Apple has any intention of fixing in the version of WebKit that Marked 2 uses.
In some cases you may get good results by exporting HTML with embedded Style and then using your web browser to print to PDF. You won’t get all of Marked’s export features, but you’ll usually get a PDF with working internal links. It’s a tradeoff for now.
Relative paths in included files
Files included using Marked’s include syntax, as well as Scrivener files, can use relative paths to reference other files. (Note: this doesn’t apply to files included using IA Writer’s
/file syntax or CSV files). As of recent versions (2.5.10+), these paths are relative to the included file, not the base file.
Given a file/folder structure like this:
- base_file.md - subfolder - included_file.md - images - image1.jpg
included_file.md references image1.jpg via a relative path, it needs to be written as
.. indicates the parent directory) .
How do I retrieve a lost license (direct version)
If you’ve lost a license you’ve purchased for Marked 2 through Paddle, you can retrieve it at my.paddle.com. If you have any trouble with logging in there, you can request a lookup via a private request on the support site.
In-app purchase issues (Error Domain=Paddle Code=0 “(null)”)
Paddle recently informed me that IAPs are broken, and that they don’t plan to fix it because not enough developers have implemented them. (Which is as frustrating to me as it is to you.) The truly frustrating part is that they haven’t stopped allowing payments, so I need to manually refund purchases until something is done about the way the licenses are handled. A new system is supposedly going to roll out in the next couple of weeks, so if you’re willing to wait, I’ll do everything I can to ensure that all current purchases of the Spelling/Grammar IAP are honored through whatever system is provided next
If you do prefer a refund, just email me directly with the email account used to license or the transaction ID from the receipt.
Update: Paddle has officially announced the new IAP solution, and it will be implemented as soon as it’s publicly available. Current in-app purchase licenses (Spelling/Grammar) will be automatically migrated, and a new coupon code will be provided. This should happen soon.
Fenced code blocks inside indented code blocks
In fairly rare circumstances you may want to show the fences of a fenced code block. Normally this could be accomplished in Markdown by indenting the fenced code, forcing an indented “verbatim” block containing the fenced code block, which would then be unprocessed. Marked handles fenced code differently (as part of its ability to work with multiple syntax options), so to accomplish this you need to use a double fence. Because you can use any number of backticks or tildes to fence a code block (as long as the opening and closing count match, you can just use two different length fences. For example
````` ``` Actual fenced code ``` `````