# Clarification of block quote spec

**URL:** <https://talk.commonmark.org/t/clarification-of-block-quote-spec/1936>\
**Category:** Spec\
**Created:** [December 10, 2015, 3:10am UTC](https://talk.commonmark.org/t/clarification-of-block-quote-spec/1936 "2015-12-10T03:10:05Z")\
**Posts on this page:** 1\
**Showing post:** 4

<div class="post-metadata">

**Author:** ![jgm](https://cdn.commonmark.org/user_avatar/talk.commonmark.org/jgm/32/1360_2.png) [@jgm](https://talk.commonmark.org/u/jgm)\
**Post date:** [December 13, 2015, 2:38am UTC](https://talk.commonmark.org/t/clarification-of-block-quote-spec/1936/4 "2015-12-13T02:38:28Z")

</div>

Descriptions that are helpful for teaching beginners are rarely sufficiently general or accurate for a spec, and spec descriptions tend to be terrible for beginners. We never imagined that beginners would want to _learn_ CommonMark by reading the spec. There should be separate documents for this purpose: see the thread [Markdown Tutorial contest feedback](http://talk.commonmark.org/t/markdown-tutorial-contest-feedback/1149).

---

_[View the full topic](https://talk.commonmark.org/t/clarification-of-block-quote-spec/1936)._