Sat, 12 Sep 2026 09:37:45 -0500

This is an example of what a post can look like when shared on social media. Thanks to the new Open Graph generator, links get a nice “card” preview with the headline of the post in the image, and a summary in the description.

Marked Share is meant for, well, sharing. So making your documents look as inviting as possible is an important part of that. Hopefully these new features will make both of us look good!

Development log: rich media, Apex fixes, and highlight cards

Wed, 09 Sep 2026 11:11:39 -0500

A short tour of what just landed on Marked Share — with live examples in this post so you can see the plumbing instead of only reading about it.

Apex 1.0.20

Share renders with Apex. 1.0.20 fixes two bugs that showed up on real documents:

Mermaid fences with edge labels like A -->|Yes| B no longer get a fake table separator injected into the diagram source.
Definition lists next to fences and callouts keep their order — prose after a DL stays before the diagram, not after it.

Older shares that were stored with broken HTML can heal on open via on-read refresh.

Definition lists

MultiMarkdown / Kramdown-style definition lists work as styled <dl> blocks again:

Term: The thing you are defining.
Mermaid: Diagrams from fenced mermaid blocks, drawn in the browser.
SVG: Inline vector markup that survives sanitization.
Math: TeX hooks from Apex ( $…$ / $$…$$), typeset when MathJax is enabled on the page.
Another term: A second definition to show stacking.; Yes, multiple definitions per term are fine.

Mermaid

Labeled edges used to corrupt the fence. This graph should render cleanly:

graph TD
  Publish[Publish Markdown] --> Apex[Apex HTML]
  Apex -->|Yes| Mermaid[Client Mermaid]
  Apex -->|No| Plain[Plain pre block]
  Mermaid --> Share[Share page]

SVG

Inline SVG is allowed through sanitization (with dangerous bits scrubbed). A simple mark:

Math

Apex emits math hooks for inline and display TeX. With MathJax on the document page, these typeset; without it you still see the TeX source rather than nothing.

Inline: the identity $e^{i\pi} + 1 = 0$ still hits.

Display:

$$ \int_{-\infty}^{\infty} e^{-x^{2}},dx = \sqrt{\pi} $$

Fenced math blocks are supported the same way Mermaid is (source in a math fence until the client runtime picks them up):

\sum_{n=1}^{\infty} \frac{1}{n^{2}} = \frac{\pi^{2}}{6}

Callouts

GitHub-style callouts are enabled in the renderer:

[!NOTE] Front matter (YAML / MMD / Pandoc) is stripped from the HTML view only. Raw download and TextBundle still include your source.

[!TIP] A paragraph that starts with Note: under an H1 is not MultiMarkdown metadata anymore — it stays on the page.

Front matter and the Word: bug

Two related fixes:

Leading YAML no longer appears as a thematic break and key/value soup on the share page.
Undelimited MultiMarkdown metadata stripping only treats conventional keys (Title, Author, …) as metadata. Prose like Note: … or First span: … under a heading stays visible. Existing shares that lost an H1 + colon paragraph can refresh on read.

Click a text highlight → share icon on the floating bar → live PNG preview with Download and Copy image.

The card is square (1080×1080): document title, gradient quote (coral → purple), attribution. Handy for pasting into Slack, Notes, or social without screenshot gymnastics. Open Graph images for ?hl= links are still a follow-up.

What else

Mermaid and callout/SVG styles on document and blog surfaces
On-read HTML refresh when stored bodies are missing rich media or were corrupted by older Apex
rubyzip bump for a known CVE

If something still looks wrong on an old link, open it once (refresh heals many cases) or republish. Bugs with a Raw vs rendered diff are especially helpful on support.

Third Test Post

Sat, 31 Jan 2026 11:05:58 -0500

This is a weird one. Where do the titles come from?

Test Post 2

Sat, 31 Jan 2026 09:45:43 -0500

How about one with categories? Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Sat, 31 Jan 2026 09:42:29 -0500

This is just a test post. I want to add Micro.blog support to BlogBook, so I need some posts to test with.

The Lab