84

Markdown ドキュメントでドキュメント タイトルを示す方法はありませんか?

個人文書やビジネス文書の多くを準備するために、Sublime Text で Markdown を使用するようになりました。たとえば、Word のタイトル スタイルに似た、一種の「トップ レベル」の見出しが必要になることがよくあります。たとえば、次のようになります。

### Things to Do ###

At Home
=======
*    Mow the cat
*    Feed the lawn

At the Office
=============
*    Learn Markdown
*    Use Big-O notation in a clever way

しかし、この### Things to Do ###行は Markdown によって尊重されておらず、別の方法がわかりません。ありますか？

タイトルに見出し 1 のスタイルを使用し、残りの部分に見出し 2 を使用することもできますが、見出しをさらに深くネストする必要がある場合は、すぐに深さが足りなくなります。そして結局のところ、タイトルは基本的にそれ自体が見出しではありません。たとえば、Markdown-to-HTML パーサーがページのタイトルと、<title>Word タイトルのようなページのトップ ヘッダーにタイトルを使用すると便利です。

4

6 に答える 6

26

Markdown の設計の興味深い点の 1 つは、HTML が明示的に許可されていることです。HTML5 では、<header> と <main> を含むセマンティック ページ セクションが追加されました。これは、ページ タイトルに適している場合があります。

例えば：

<header>
Things to Do
============
</header>
<main>
At Home
=======
*    Mow the cat
*    Feed the lawn

At the Office
=============
*    Learn Markdown
*    Use Big-O notation in a clever way
</main>

HTML を除外する方が望ましい場合は、2 レベル以上の階層を取得するために Atx スタイルの見出しを使用することをお勧めします。

例えば：

# Things to Do

## At Home
*    Mow the cat
*    Feed the lawn

## At the Office
### Morning
*    Learn Markdown
*    Use Big-O notation in a clever way
### Afternoon
*    Read e-mails
*    Scrutinize LOLcats
于 2013-06-13T22:17:10.850 に答える
7

タイトルメタデータ

MultiMarkdown を使用している場合は、ドキュメントの上部にメタデータを追加できます

format: complete
title: This is a title for the web-page
css: http://example.com/main.css

First line of visible text

タイトルはセクションの a<title>に含まれます<head>

[%title])を使用して、参照によって本文に含めることもできます。

小見出し

###最初の行の先頭にある をレベル 3 ヘッダーとして認識して<h3>タグを生成するのに問題はないはずです。Markdown/MultiMarkdown のいくつかの実装でこれを使用します

John Gruber の Dingus、Markableなどを使用してテストできます。

見出しオフセット

少なくとも一部の Markdown/Multimarkdown 実装では、生成された見出しのオフセットを指定して、<h2>and<h3>の代わりに<h1>andを生成できます<h2>。

これにより、たとえば、<h1>Title</h1>または<h1>[%title]</h1>ドキュメントの最初の行 (メタデータ宣言の後) として配置できます。

参考文献

于 2015-02-05T17:27:52.343 に答える