# Document titles

**URL:** <https://talk.commonmark.org/t/document-titles/649>\
**Category:** Extensions\
**Created:** [September 20, 2014, 12:28am UTC](https://talk.commonmark.org/t/document-titles/649 "2014-09-20T00:28:37Z")\
**Posts on this page:** 4\
**Page:** 3

<div class="post-metadata">

**Author:** ![mofosyne](https://cdn.commonmark.org/user_avatar/talk.commonmark.org/mofosyne/32/1438_2.png) [@mofosyne](https://talk.commonmark.org/u/mofosyne)\
**Post date:** [October 2, 2014, 10:51am UTC](https://talk.commonmark.org/t/document-titles/649/43 "2014-10-02T10:51:17Z")

</div>

I see. Just noticed that thread about it [Description List](http://talk.commonmark.org/t/description-list/289/2)

Well lets just stick to only this form then, for lazy meta data description. I have not seen many objection to this form. Just don’t stack it. It’s in YAML.

```
| !CommonMark: 0.1.23-github.username.projectname
| title: Title for the top bar of any browser
| layout: report
```

---

<div class="post-metadata">

**Author:** ![chrisalley](https://cdn.commonmark.org/user_avatar/talk.commonmark.org/chrisalley/32/906_2.png) [@chrisalley](https://talk.commonmark.org/u/chrisalley)\
**Post date:** [October 2, 2014, 11:06am UTC](https://talk.commonmark.org/t/document-titles/649/44 "2014-10-02T11:06:39Z")

</div>

I would probably still use the Jekyll style front matter as it does not require the writer to add `|` at the start of every line. It’s also consistent with how code blocks are written. No strong objection to including both though.

---

<div class="post-metadata">

**Author:** ![chrisalley](https://cdn.commonmark.org/user_avatar/talk.commonmark.org/chrisalley/32/906_2.png) [@chrisalley](https://talk.commonmark.org/u/chrisalley)\
**Post date:** [October 2, 2014, 11:14am UTC](https://talk.commonmark.org/t/document-titles/649/45 "2014-10-02T11:14:33Z")

</div>

Actually, there is an objection. Pandoc uses a pipe at the start of a line to represent [a line block](http://johnmacfarlane.net/pandoc/README.html#line-blocks). I think this is the equivalent of the `<pre>` tag in HTML. It looks like a useful extension to have.

Perhaps something similar to Pandoc [metadata blocks](http://johnmacfarlane.net/pandoc/README.html#metadata-blocks) could be supported instead, e.g.

```markdown
% title: Title for the top bar of any browser
% layout: report

```

---

<div class="post-metadata">

**Author:** ![lu\_zero](https://cdn.commonmark.org/user_avatar/talk.commonmark.org/lu_zero/32/557_2.png) [@lu\_zero](https://talk.commonmark.org/u/lu_zero)\
**Post date:** [October 6, 2014, 6:05am UTC](https://talk.commonmark.org/t/document-titles/649/46 "2014-10-06T06:05:37Z")

</div>

% seems not used for other purposes in the usual suspects so might be good together with the Jekyll/Hyde/Flask-FlatPages/nanoc syntax.

[Previous page](https://talk.commonmark.org/t/document-titles/649.md?page=2)