# Uncategorized

**URL:** https://talk.commonmark.org/c/uncategorized/1.md

[Latest](https://talk.commonmark.org/latest.md) · [Categories](https://talk.commonmark.org/categories.md) · [Tags](https://talk.commonmark.org/tags.md)

---

## [Welcome to CommonMark Discussion](https://talk.commonmark.org/t/welcome-to-commonmark-discussion/8)

<div class="topic-metadata">

**Author:** [@system](https://talk.commonmark.org/u/system)\
**Replies:** 0\
**Last updated:** [August 18, 2014, 7:54am UTC](https://talk.commonmark.org/t/welcome-to-commonmark-discussion/8 "2014-08-18T07:54:29Z")

</div>

Markdown is a plain text format for writing structured documents. CommonMark, is a strongly defined, highly compatible specification of Markdown, along with a suite of comprehensive tests to validate implementations. Th…

---

## [Standardize listing of Markdown Flavors used in the MD document: GLFM, GFM, QMD, etc](https://talk.commonmark.org/t/standardize-listing-of-markdown-flavors-used-in-the-md-document-glfm-gfm-qmd-etc/9064)

<div class="topic-metadata">

**Author:** [@murz](https://talk.commonmark.org/u/murz)\
**Replies:** 5\
**Last updated:** [October 3, 2026, 7:28pm UTC](https://talk.commonmark.org/t/standardize-listing-of-markdown-flavors-used-in-the-md-document-glfm-gfm-qmd-etc/9064 "2026-10-03T19:28:43Z")

</div>

Standardizing a single common Markdown syntax seems like an impossible challenge! So, now we already have a lot of different popular “flavors” for Markdown syntax: CommonMark, GitLab Flavored Markdown (GLFM), GitHub Fla…

---

## [Code fences in list items](https://talk.commonmark.org/t/code-fences-in-list-items/9143)

<div class="topic-metadata">

**Author:** [@brainchild](https://talk.commonmark.org/u/brainchild)\
**Replies:** 2\
**Last updated:** [September 18, 2026, 11:55pm UTC](https://talk.commonmark.org/t/code-fences-in-list-items/9143 "2026-09-18T23:55:15Z")

</div>

I have been struggling with code blocks within list items. The combination may seem most natural to represent as in the following: - One \`\`\` foo \`\`\` ​ - Two ​ \`\`\` bar \`\`\` Indeed, it appears with most re…

---

## [Interesting trend of executable markdown readme projects (Syntax comparison)](https://talk.commonmark.org/t/interesting-trend-of-executable-markdown-readme-projects-syntax-comparison/4577)

<div class="topic-metadata">

**Author:** [@mofosyne](https://talk.commonmark.org/u/mofosyne)\
**Replies:** 2\
**Last updated:** [August 28, 2026, 4:48pm UTC](https://talk.commonmark.org/t/interesting-trend-of-executable-markdown-readme-projects-syntax-comparison/4577 "2026-08-28T16:48:38Z")

</div>

Just noticed there is a whole bunch of projects focusing on executable readmes. Can you remind me what’s the common consensus on attributes for code blocks? I think Runme has the closest form to what was discussed rega…

---

## [A (somewhat) formally verified implementation of Markdown](https://talk.commonmark.org/t/a-somewhat-formally-verified-implementation-of-markdown/9108)

<div class="topic-metadata">

**Author:** [@paulbutcher](https://talk.commonmark.org/u/paulbutcher)\
**Replies:** 0\
**Last updated:** [August 8, 2026, 7:47am UTC](https://talk.commonmark.org/t/a-somewhat-formally-verified-implementation-of-markdown/9108 "2026-08-08T07:47:17Z")

</div>

I’d like to announce lean-markdown a Lean implementation of both CommonMark and GitHub Flavored Markdown (GFM). A (somewhat) formally verified implementation of Markdown Guarantees Conformant: passes every test in the…

---

## [CommonMark Formal Grammar](https://talk.commonmark.org/t/commonmark-formal-grammar/46)

<div class="topic-metadata">

**Author:** [@imsky](https://talk.commonmark.org/u/imsky)\
**Replies:** 38\
**Last updated:** [March 12, 2026, 1:19pm UTC](https://talk.commonmark.org/t/commonmark-formal-grammar/46 "2026-03-12T13:19:34Z")

</div>

Is a language-independent formal grammar for CMD available? The re2c files in the stmd repo are a good reference point, but a standalone PEG would be really useful.

---

## [Strange render issues of unordered lists used in Javadoc comments of Java 23](https://talk.commonmark.org/t/strange-render-issues-of-unordered-lists-used-in-javadoc-comments-of-java-23/4749)

<div class="topic-metadata">

**Author:** [@Andre601](https://talk.commonmark.org/u/Andre601)\
**Replies:** 5\
**Last updated:** [August 3, 2025, 2:29am UTC](https://talk.commonmark.org/t/strange-render-issues-of-unordered-lists-used-in-javadoc-comments-of-java-23/4749 "2025-08-03T02:29:35Z")

</div>

Can’t find a better place to ask this, so apologiez in advance if there was a better place for discussing this. I use Markdown in Javadoc comments, because Java 23 implemented support for Markdown in them using a new sy…

---

## [Best Practices and Challenges in Extending CommonMark for Custom Use Cases](https://talk.commonmark.org/t/best-practices-and-challenges-in-extending-commonmark-for-custom-use-cases/5028)

<div class="topic-metadata">

**Author:** [@Harry](https://talk.commonmark.org/u/Harry)\
**Replies:** 1\
**Last updated:** [June 8, 2025, 2:06am UTC](https://talk.commonmark.org/t/best-practices-and-challenges-in-extending-commonmark-for-custom-use-cases/5028 "2025-06-08T02:06:20Z")

</div>

Hi everyone, I’ve been exploring CommonMark for a while now and really appreciate its clean, unambiguous spec and the way it strives for consistent Markdown parsing across implementations. I’m currently working on a pro…

---

## [How do I use the Markdown to HTML C function and statically compile?](https://talk.commonmark.org/t/how-do-i-use-the-markdown-to-html-c-function-and-statically-compile/5009)

<div class="topic-metadata">

**Author:** [@Zzzzh289](https://talk.commonmark.org/u/Zzzzh289)\
**Replies:** 0\
**Last updated:** [May 4, 2025, 12:41pm UTC](https://talk.commonmark.org/t/how-do-i-use-the-markdown-to-html-c-function-and-statically-compile/5009 "2025-05-04T12:41:49Z")

</div>

I would like to use this library, and convert Markdown to HTML. Unfortunately, I couldn’t find documentation with easy examples. There was some “Make\_manpages.py” thing I didn’t understand. I couldn’t use python to make …

---

## [Fenced Code Blocks: Tilde vs Backtick](https://talk.commonmark.org/t/fenced-code-blocks-tilde-vs-backtick/4907)

<div class="topic-metadata">

**Author:** [@znewt99](https://talk.commonmark.org/u/znewt99)\
**Replies:** 4\
**Last updated:** [February 15, 2025, 2:18pm UTC](https://talk.commonmark.org/t/fenced-code-blocks-tilde-vs-backtick/4907 "2025-02-15T14:18:02Z")

</div>

What do y’all use more often? Please, explain why in a comment below. If y’all use a mix of both, comment below what do you use each method for? poll

---

## [CJK and bold tags \*\* possibly complex issue?](https://talk.commonmark.org/t/cjk-and-bold-tags-possibly-complex-issue/4034)

<div class="topic-metadata">

**Author:** [@Roger](https://talk.commonmark.org/u/Roger)\
**Replies:** 6\
**Last updated:** [February 2, 2025, 12:22pm UTC](https://talk.commonmark.org/t/cjk-and-bold-tags-possibly-complex-issue/4034 "2025-02-02T12:22:50Z")

</div>

There is a previous thread from 2020: This highlights the case I run into in present. As background: I’m dealing primarily with Chinese, Japanese and Arabic but with people on the team from each respective area, and t…

---

## [Could list spec be stricter?](https://talk.commonmark.org/t/could-list-spec-be-stricter/4735)

<div class="topic-metadata">

**Author:** [@Iagoba\_Apellaniz](https://talk.commonmark.org/u/Iagoba_Apellaniz)\
**Replies:** 4\
**Last updated:** [October 8, 2024, 9:52am UTC](https://talk.commonmark.org/t/could-list-spec-be-stricter/4735 "2024-10-08T09:52:16Z")

</div>

I find confusing that the text below is a completely readable paragraph but it is interpreted as paragraph and a list While the sum of 3 and 2 is 5, its difference is 1. One can also multiply them to obtain 6. Dividing …

---

## [Remove HTML passthru/pass through](https://talk.commonmark.org/t/remove-html-passthru-pass-through/1869)

<div class="topic-metadata">

**Author:** [@binki](https://talk.commonmark.org/u/binki)\
**Replies:** 10\
**Last updated:** [August 19, 2024, 10:57pm UTC](https://talk.commonmark.org/t/remove-html-passthru-pass-through/1869 "2024-08-19T22:57:31Z")

</div>

I really like Markdown. My understanding of its goal is to take plaintext that a human wrote and intended for other humans to be able to read directly and translate marking indicating emphasis/whatnot into HTML. User-pro…

---

## [Off-topic: m3u playlist spec](https://talk.commonmark.org/t/off-topic-m3u-playlist-spec/4695)

<div class="topic-metadata">

**Author:** [@avidseeker](https://talk.commonmark.org/u/avidseeker)\
**Replies:** 0\
**Last updated:** [July 5, 2024, 4:35am UTC](https://talk.commonmark.org/t/off-topic-m3u-playlist-spec/4695 "2024-07-05T04:35:32Z")

</div>

Sorry for the off-topic, but I thought this community would be the best place to find people interested in plain text file formats and their specs. M3U is old and there is no formal specification for it. Many extensions…

---

## [Assistance Needed in CommonMark for Nested Lists and Custom Styling](https://talk.commonmark.org/t/assistance-needed-in-commonmark-for-nested-lists-and-custom-styling/4687)

<div class="topic-metadata">

**Author:** [@James24](https://talk.commonmark.org/u/James24)\
**Replies:** 1\
**Last updated:** [June 27, 2024, 7:53am UTC](https://talk.commonmark.org/t/assistance-needed-in-commonmark-for-nested-lists-and-custom-styling/4687 "2024-06-27T07:53:38Z")

</div>

Hello Everyone :hugs:, I have been experimenting with CommonMark’s features for an individual endeavour, even though I am very new to it. Although the material has been quite helpful, I’ve encountered a couple problems …

---

## [Should MD containing HTML tags be wrapped in \`\<html\>\`?](https://talk.commonmark.org/t/should-md-containing-html-tags-be-wrapped-in-html/4681)

<div class="topic-metadata">

**Author:** [@rokejulianlockhart](https://talk.commonmark.org/u/rokejulianlockhart)\
**Replies:** 0\
**Last updated:** [June 21, 2024, 2:16pm UTC](https://talk.commonmark.org/t/should-md-containing-html-tags-be-wrapped-in-html/4681 "2024-06-21T14:16:27Z")

</div>

Undermentioned is the content in a Markdown file of mine that immediately proceeds its YAML preamble: \<!docType Markdown\> \<head\>\<meta charSet = "UTF-8"\>\</head\> \<style\> :is(h1) { font-size: 1.5em; } :is(h2, h3, h4,…

---

## [Made a first stab at a C markdown table format to json program - psv.c](https://talk.commonmark.org/t/made-a-first-stab-at-a-c-markdown-table-format-to-json-program-psv-c/4653)

<div class="topic-metadata">

**Author:** [@mofosyne](https://talk.commonmark.org/u/mofosyne)\
**Replies:** 2\
**Last updated:** [April 25, 2024, 2:49am UTC](https://talk.commonmark.org/t/made-a-first-stab-at-a-c-markdown-table-format-to-json-program-psv-c/4653 "2024-04-25T02:49:57Z")

</div>

A while ago, I was bikeshedding over the idea of a pipe separated value ‘psv’ file format which is essentially just a markdown table. I think i figured out at least a reasonable format now. Hopefully this will inform wha…

---

## [Support for \`\`\`quote ...\`\`\`](https://talk.commonmark.org/t/support-for-quote/4493)

<div class="topic-metadata">

**Author:** [@guettli](https://talk.commonmark.org/u/guettli)\
**Replies:** 4\
**Last updated:** [April 7, 2024, 8:52am UTC](https://talk.commonmark.org/t/support-for-quote/4493 "2024-04-07T08:52:31Z")

</div>

If I want to quote several lines, I need to add \> at the beginning of every line. This is doable, but not convenient. Zulip supports “quote” after the trible backticks. It would be great to have this in commonmarkdown…

---

## [ANN: commonmark 0.31.2](https://talk.commonmark.org/t/ann-commonmark-0-31-2/4591)

<div class="topic-metadata">

**Author:** [@jgm](https://talk.commonmark.org/u/jgm)\
**Replies:** 0\
**Last updated:** [January 29, 2024, 2:22am UTC](https://talk.commonmark.org/t/ann-commonmark-0-31-2/4591 "2024-01-29T02:22:10Z")

</div>

Version 0.31.2 of the CommonMark spec has been released: spec changelog diff I have also released conforming versions of the reference implementations cmark commonmark.js Most of the changes to the spec are very mi…

---

## [Parsing document and nesting in larger AST](https://talk.commonmark.org/t/parsing-document-and-nesting-in-larger-ast/4583)

<div class="topic-metadata">

**Author:** [@Ericson2314](https://talk.commonmark.org/u/Ericson2314)\
**Replies:** 1\
**Last updated:** [January 17, 2024, 12:27am UTC](https://talk.commonmark.org/t/parsing-document-and-nesting-in-larger-ast/4583 "2024-01-17T00:27:29Z")

</div>

Hi I am trying to programmatically create some markdown with cmark by combining parsed sub-document (and some manually created leaf nodes) in a larger AST. cmark\_node\_append\_child however doesn’t like it when the child …

---

## [Code span with leading newline](https://talk.commonmark.org/t/code-span-with-leading-newline/4546)

<div class="topic-metadata">

**Author:** [@notriddle](https://talk.commonmark.org/u/notriddle)\
**Replies:** 0\
**Last updated:** [November 25, 2023, 9:48pm UTC](https://talk.commonmark.org/t/code-span-with-leading-newline/4546 "2023-11-25T21:48:09Z")

</div>

Consider the ASCII string: 60 0A 20 60 \` \` I’m reading the CommonMark Spec, trying to understand what it calls for in this case. First, line endings are converted to spaces. If the resulting string both begins and …

---

## [Non-spaced indented entirely automatically numbered lists do not render, and spaced lists do not render correct subsequent line spacing](https://talk.commonmark.org/t/non-spaced-indented-entirely-automatically-numbered-lists-do-not-render-and-spaced-lists-do-not-render-correct-subsequent-line-spacing/4453)

<div class="topic-metadata">

**Author:** [@rokejulianlockhart](https://talk.commonmark.org/u/rokejulianlockhart)\
**Replies:** 2\
**Last updated:** [November 19, 2023, 12:53am UTC](https://talk.commonmark.org/t/non-spaced-indented-entirely-automatically-numbered-lists-do-not-render-and-spaced-lists-do-not-render-correct-subsequent-line-spacing/4453 "2023-11-19T00:53:02Z")

</div>

https://github.com/markdown-it/markdown-it/issues/939#issue-1750584686 Summarily, nested non-spaced automatically numbered (0.) lists don’t render more than one level deep without indentation, whereas manually numbered…

---

## [How to show generic email address without it becoming a hyperlink?](https://talk.commonmark.org/t/how-to-show-generic-email-address-without-it-becoming-a-hyperlink/3956)

<div class="topic-metadata">

**Author:** [@dominickmurphy](https://talk.commonmark.org/u/dominickmurphy)\
**Replies:** 3\
**Last updated:** [November 17, 2023, 11:19am UTC](https://talk.commonmark.org/t/how-to-show-generic-email-address-without-it-becoming-a-hyperlink/3956 "2023-11-17T11:19:10Z")

</div>

What is the MarkDown language for using a generic email address for a set of instructions without the email address becoming a hyperlink? For example … blah blah blah… Step 2 type in your email address (example: yourna…

---

## [Feedback on commonmark and request for some additional capabilities](https://talk.commonmark.org/t/feedback-on-commonmark-and-request-for-some-additional-capabilities/4540)

<div class="topic-metadata">

**Author:** [@ww12](https://talk.commonmark.org/u/ww12)\
**Replies:** 2\
**Last updated:** [November 16, 2023, 9:44pm UTC](https://talk.commonmark.org/t/feedback-on-commonmark-and-request-for-some-additional-capabilities/4540 "2023-11-16T21:44:31Z")

</div>

Hello - this is my first post on this forum. The commonmark website asks for feedback, and I have been advised that this forum is the right place to bring that. I am writing, as a user, because I have noticed some things…

---

## [How to use local image?](https://talk.commonmark.org/t/how-to-use-local-image/4507)

<div class="topic-metadata">

**Author:** [@vincent](https://talk.commonmark.org/u/vincent)\
**Replies:** 1\
**Last updated:** [September 3, 2023, 9:17pm UTC](https://talk.commonmark.org/t/how-to-use-local-image/4507 "2023-09-03T21:17:37Z")

</div>

Hello everybody, I’m new on this forum. I’m working on the Eclipse Papyrus Project. The purpose of this project is to provide a graphical editor for UML. In this context, we are connecting the commonmark (0.21) editor …

---

## [Mermaid - Generation of diagrams and flowcharts from text in a similar manner as markdown](https://talk.commonmark.org/t/mermaid-generation-of-diagrams-and-flowcharts-from-text-in-a-similar-manner-as-markdown/1882)

<div class="topic-metadata">

**Author:** [@mofosyne](https://talk.commonmark.org/u/mofosyne)\
**Replies:** 65\
**Last updated:** [August 21, 2023, 3:36pm UTC](https://talk.commonmark.org/t/mermaid-generation-of-diagrams-and-flowcharts-from-text-in-a-similar-manner-as-markdown/1882 "2023-08-21T15:36:26Z")

</div>

Looks pretty interesting. It aims to be like markdown, but for diagrams. http://knsv.github.io/mermaid/ Wonder how one would support this within commonmark, even if it's as an extension hook. If using custom contai…

---

## [How do I add style to markdown](https://talk.commonmark.org/t/how-do-i-add-style-to-markdown/4441)

<div class="topic-metadata">

**Author:** [@Mrdev88](https://talk.commonmark.org/u/Mrdev88)\
**Replies:** 1\
**Last updated:** [May 16, 2023, 7:57am UTC](https://talk.commonmark.org/t/how-do-i-add-style-to-markdown/4441 "2023-05-16T07:57:36Z")

</div>

How do I add style to markdown

---

## [Example 126 confusion (autoclosing fence blocks)](https://talk.commonmark.org/t/example-126-confusion-autoclosing-fence-blocks/4335)

<div class="topic-metadata">

**Author:** [@dbuenzli](https://talk.commonmark.org/u/dbuenzli)\
**Replies:** 11\
**Last updated:** [February 15, 2023, 5:04pm UTC](https://talk.commonmark.org/t/example-126-confusion-autoclosing-fence-blocks/4335 "2023-02-15T17:04:32Z")

</div>

Hello, I’m slightly confused by the output of example 126 whose input is "\`\`\`\\n" and output: \<pre\>\<code\>\</code\>\</pre\> My reading is is that we have a(n empty) line here and that is should rather be: \<pre\>\<code\> \</cod…

---

## [Under which condition start a new list?](https://talk.commonmark.org/t/under-which-condition-start-a-new-list/4391)

<div class="topic-metadata">

**Author:** [@Volker\_Berlin](https://talk.commonmark.org/u/Volker_Berlin)\
**Replies:** 1\
**Last updated:** [February 7, 2023, 9:05pm UTC](https://talk.commonmark.org/t/under-which-condition-start-a-new-list/4391 "2023-02-07T21:05:23Z")

</div>

Why does not start the follow Markdown a new list in the demo and the spec tests? foo \* But the follow do it: foo \* and foo \* text This look like a bug for me. Which of the rules int he spec described this…

---

## [Doctype declaration handling is case sensitive](https://talk.commonmark.org/t/doctype-declaration-handling-is-case-sensitive/4295)

<div class="topic-metadata">

**Author:** [@Evgeny\_Naumenko](https://talk.commonmark.org/u/Evgeny_Naumenko)\
**Replies:** 0\
**Last updated:** [September 21, 2022, 2:00pm UTC](https://talk.commonmark.org/t/doctype-declaration-handling-is-case-sensitive/4295 "2022-09-21T14:00:10Z")

</div>

As seen here the html doctype is not recognized when lowercased. It works properly with DOCTYPE though. Given that the doctype should be case insensitive I wonder if this is refernce implementation bug I’m facing.

[Next page](https://talk.commonmark.org/c/uncategorized/1.md?page=1)