Што азначае Markdown? Як выкарыстоўваць разметку сінтаксісу/фарматавання Markdown?

ўцэнкаШто значыць?

Як выкарыстоўваць разметку сінтаксісу/фарматавання Markdown?

Агляд

Markdown - гэта лёгкая мова разметкі, створаная Джонам Груберам.

Гэта дазваляе людзям "пісаць дакументы ў фармаце звычайнага тэксту, які лёгка чытаць і пісаць, а затым канвертаваць іх у сапраўдныя дакументы XHTML (або HTML)".

Мова ўключае ў сябе шмат функцый разметкі звычайнага тэксту, якія ўжо ёсць у электроннай пошце.

Джон Грубер стварыў мову Markdown у 2004 годзе ў супрацоўніцтве з Ааронам Суорцам у значнай ступені над сінтаксісам.Мэта мовы - выкарыстоўваць «фармат звычайнага тэксту, які лёгка чытаць, лёгка пісаць і пры жаданні пераўтвараць у сапраўдны XHTML (або HTML)».

мэта

Мэта Markdown - быць "лёгкім для чытання і лёгкім для напісання".

чытальнасць, зрабіце гэта ў любым выпадку网络 营销, карыстацкі досвед вельмі важны.

Дакумент, напісаны ў Markdown, павінен быць апублікаваны непасрэдна ў выглядзе звычайнага тэксту, і ён не павінен складацца з мноства тэгаў або дырэктываў фарматавання.

На сінтаксіс Markdown уплываюць некаторыя існуючыя фарматы пераўтварэння тэксту ў HTML, у тым ліку Setext, atx, Textile, reStructuredText, Grutatext і EtText, але самай вялікай крыніцай натхнення з'яўляецца фармат электроннай пошты з простым тэкстам.

Карацей кажучы, увесь сінтаксіс Markdown складаецца з сімвалаў, якія старанна адабраны, а іх функцыі зразумелыя з першага погляду.Напрыклад: пастаўце зорачкі вакол тэксту, каб ён выглядаў як *вылучэнне*.

Спісы ў Markdown выглядаюць як спісы. Цытаты ў Markdown сапраўды выглядаюць як цытаванне фрагмента тэксту, як вы бачылі ў электронных лістах.

Сумяшчальны з HTML

Мэта граматыкі Markdown - стаць пісьмовай мовай для Інтэрнэту.

Markdown не прызначаны для замены HTML або нават набліжэння да яго, ён мае вельмі мала тыпаў сінтаксісу і адпавядае толькі невялікай частцы разметкі HTML. Markdown не быў задуманы для палягчэння напісання дакументаў HTML.

На мой погляд, HTML ужо лёгка напісаць. Ідэя Markdown заключаецца ў тым, каб зрабіць дакументы лягчэй чытаць, пісаць і змяняць па жаданні. HTML - гэта фармат публікацыі, Markdown - гэтаКапірайтынгпісьмовы фармат.Такім чынам, сінтаксіс фарматавання Markdown ахоплівае толькі тое, што можа зрабіць звычайны тэкст.

Тэгі, якія не ахопліваюцца Markdown, могуць быць запісаны ў HTML непасрэдна ў дакуменцеПрасоўванне ў інтэрнэцекопія.Няма неабходнасці пазначаць гэта як HTML або Markdown; проста дадайце разметку непасрэдна.

Толькі некаторыя элементы блока HTML павінны быць абмежаваныя - напрыклад <div>,<table>,<pre>,<p> і іншыя тэгі, яны павінны быць аддзеленыя ад іншых абласцей змесціва пустымі радкамі перад і пасля, а іх адкрываючыя і зачыняльныя тэгі не павінны мець водступ табуляцыі або прабелаў. Генератар Markdown дастаткова разумны, каб не дадаваць непатрэбныя тэгі блока HTML <p> этыкетка.

Прыклад выглядае наступным чынам: даданне табліцы HTML у файл Markdown:

这是一个普通段落。

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

这是另一个普通段落。

Звярніце ўвагу, што сінтаксіс фарматавання Markdown паміж тэгамі блока HTML апрацоўвацца не будзе.Напрыклад, калі вы выкарыстоўваеце стыль Markdown у блоку HTML*强调*не будзе мець ніякага эфекту.

Тэгі раздзела HTML (убудаваныя), такія як <span>,<cite>,<del> Можа свабодна выкарыстоўвацца ў абзацах Markdown, спісах або загалоўках.Згодна з асабістымі звычкамі, вы нават можаце выкарыстоўваць тэгі HTML для фарматавання без выкарыстання фармату Markdown.Прыклад: калі вы аддаеце перавагу HTML <a> Або <img> тэгі, якія можна выкарыстоўваць непасрэдна без спасылак або сінтаксісу тэгаў выявы, прадастаўленага Markdown.

У адрозненне ад блокавых тэгаў HTML, сінтаксіс Markdown дзейнічае паміж тэгамі раздзелаў HTML.

Аўтаматычнае пераўтварэнне спецыяльных сімвалаў

У файлах HTML ёсць два сімвалы, якія патрабуюць спецыяльнай апрацоўкі: < 和 & . < сімвалы выкарыстоўваюцца для пачатковых тэгаў,& Сімвалы выкарыстоўваюцца для пазначэння аб'ектаў HTML, калі вы проста хочаце паказаць прататып гэтых сімвалаў, вы павінны выкарыстоўваць форму аб'ектаў, напрыклад < 和 &.

& Сімвалы асабліва мучаць аўтараў вэб-дакументаў, калі вы збіраецеся ўводзіць "AT&T", вы павінны напісаць"AT&T".у той час як у URL & Персанажы таксама канвертуюцца.Напрыклад, вы хочаце зрабіць спасылку на:

http://images.google.com/images?num=30&q=larry+bird

Вы павінны запісаць пераўтварэнне URL як:

http://images.google.com/images?num=30&q=larry+bird

для размяшчэння ў тэгу спасылкі href ва ўласцівасцях.Залішне казаць, што гэта лёгка ігнараваць, і, верагодна, найбольшая колькасць памылак, выяўленых пры праверцы стандартаў HTML.

Markdown дазваляе вам пісаць сімвалы натуральным чынам, і ён клапоціцца пра тое, што трэба пераўтварыць.калі вы выкарыстоўваеце & Сімвал з'яўляецца часткай сімвала HTML, ён застаецца як ёсць, у адваротным выпадку ён пераўтворыцца ў &;。

Такім чынам, калі вы хочаце ўставіць у дакумент сімвал аўтарскага права ©, вы можаце напісаць:

©

Markdown пакіне яго некранутым.А калі напісаць:

AT&T

Markdown пераўтворыць яго ў:

AT&T

Падобная сітуацыя таксама мае месца ў < натацыю, так як Markdown дазваляе сумяшчальнасць з HTML, калі вы паставіце < Сімвалы выкарыстоўваюцца ў якасці раздзяляльнікаў для тэгаў HTML, і Markdown не будзе выконваць іх пераўтварэнні, але калі вы напішаце:

4 < 5

Markdown пераўтворыць яго ў:

4 < 5

Аднак варта адзначыць, што ў рамках кода, будзь ён убудаваны або блочны, < 和 & абодва сімвалынапэўнапераўтвараюцца ў аб'екты HTML, функцыя, якая дазваляе лёгка пісаць HTML-код у Markdown (у адрозненне ад HTML, куды вы змяшчаеце ўсе < 和 & Усе яны пераўтворацца ў аб'екты HTML, каб запісаць HTML-код у файл HTML. )

блокавы элемент

Абзацы і разрывы радкоў

Абзац Markdown складаецца з аднаго або некалькіх паслядоўных радкоў тэксту, перад і пасля якіх ідуць больш чым адзін пусты радок (вызначэнне пустога радка заключаецца ў тым, што ён здаецца пустым на дысплеі і лічыцца пустым радком. Напрыклад, , калі радок змяшчае толькі прабелы і табуляцыі, радок таксама будзе разглядацца як пусты радок).Звычайныя абзацы не павінны мець водступы з прабеламі або табуляцыямі.

Фраза «складаецца з аднаго або некалькіх паслядоўных радкоў тэксту» фактычна азначае, што Markdown дазваляе прымусова пераводзіць новыя радкі (устаўку новых радкоў) у абзацах, асаблівасць, якая адрозніваецца ад большасці іншых фарматаў пераўтварэння тэксту ў HTML (уключаючы рухомы тып «Пераўтварыць разрывы радкоў» "), іншыя фарматы будуць пераўтвараць кожны разрыў радка ў <br /> этыкетка.

Калі тысапраўдыХочаце спадзявацца на Markdown для ўстаўкі <br /> Для этыкетак націсніце два ці больш прабелаў у месцы ўстаўкі, а затым націсніце Enter.

Сапраўды, для стварэння патрабуецца крыху больш працы (дадатковыя прасторы). <br /> , але проста «кожны новы радок пераўтворыцца ў <br />«Метад не падыходзіць у Markdown, эм у MarkdownaiЦытаты ў стылі L і спісы з некалькіх абзацаў не толькі больш карысныя, але і лягчэй чытаць пры наборы з разрывамі радкоў.

загаловак

Markdown падтрымлівае два сінтаксісы для загалоўкаў, Setext-падобны і atx-падобны.

Форма, падобная да Settext, - гэта форма з ніжнім радком, выкарыстоўваючы = (вышэйшае званне) і - (Загалоўкі другога парадку), напрыклад:

This is an H1
=============

This is an H2
-------------

любую суму = 和 - можа быць эфектыўным.

Atx-падобная форма ўстаўляе ад 1 да 6 у пачатку радка # , адпаведныя загалоўкам з 1 па 6, напрыклад:

# 这是 H1

## 这是 H2

###### 这是 H6

Пры жаданні вы можаце "закрыць" загалоўкі, падобныя на atx, гэта чыста для эстэтыкі, калі вам зручна, вы можаце дадаць гэта ў канцы радка #, а канчаткі радкоў # Нумар не павінен супадаць з пачаткам (колькасць сімвалаў у фунтах у пачатку радка вызначае парадак загалоўка):

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

Блокавыя цытаты Блокавыя цытаты

Каціроўкі разметкі ўцэнкі выкарыстоўваюцца аналагічна тым, што выкарыстоўваюцца ў электроннай пошце > цытат.Калі вы знаёмыя з цытатамі ў электронных лістах, вы ведаеце, як стварыць блок-цытату ў файле Markdown, які будзе выглядаць так, быццам вы самі разбіваеце радкі, а потым дада > :

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> 
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.

Markdown таксама дазваляе вам паленавацца і дадаць толькі першы радок усяго абзаца > :

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

Спасылкі на блокі могуць быць укладзенымі (напрыклад: спасылкі ў спасылках) шляхам дадання рознай колькасці > :

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

Іншы сінтаксіс Markdown таксама можа выкарыстоўвацца ў блоках у цытатах, уключаючы загалоўкі, спісы, блокі кода і г.д.:

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码：
> 
>     return shell_exec("echo $input | $markdown_script");

Любы прыстойны тэкставы рэдактар ​​можа лёгка ствараць цытаты ў стылі электроннай пошты.Напрыклад, у BBEdit вы можаце выбраць тэкст, а затым выбраць з менюпавялічыць іерархію цытавання.

Спіс

Уцэнка 支持 有序 列表 和 无序 列表。

Неўпарадкаваныя спісы выкарыстоўваюць зорачкі, знакі плюс або мінус у якасці маркераў спісаў:

*   Red
*   Green
*   Blue

Эквівалентна:

+   Red
+   Green
+   Blue

Таксама эквівалентна:

-   Red
-   Green
-   Blue

У парадкаваных спісах выкарыстоўваюцца лічбы, за якімі ідзе кропка:

1.  Bird
2.  McHale
3.  Parish

Важна адзначыць, што лічбы, якія вы выкарыстоўваеце ў тэгу спісу, не ўплываюць на выходны HTML. Выніковая разметка HTML для прыведзенага вышэй спісу будзе:

<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

Калі ваша разметка спісу напісана так:

1.  Bird
1.  McHale
1.  Parish

ці нават:

3. Bird
1. McHale
8. Parish

Вы абодва атрымаеце аднолькавы вынік HTML.Справа ў тым, што вы можаце зрабіць нумары спісу ў файле Markdown такімі ж, як вынікі вываду, або, калі вам лянота, вам наогул не трэба клапаціцца аб правільнасці лічбаў.

Калі вы выкарыстоўваеце лянівы запіс, рэкамендуецца пачынаць з 1. для першага элемента, таму што Markdown можа падтрымліваць атрыбут пачатку ўпарадкаваных спісаў у будучыні.

Тэг элемента спіса звычайна размяшчаецца ў крайнім левым краі, але ён можа мець водступ да 3 прабелаў, і за тэгам элемента павінен ісці хаця б адзін прабел або табуляцыя.

Каб зрабіць спіс больш прыгожым, вы можаце арганізаваць змесціва з фіксаваным водступам:

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
    viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
    Suspendisse id sem consectetuer libero luctus adipiscing.

Але калі вы лянівы, гэта таксама добра:

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

Калі элементы спісу падзеленыя пустымі радкамі, Markdown будзе выкарыстоўваць змесціва элемента пры вывадзе HTML. <p> Этыкеткі заварочваюцца, напрыклад:

*   Bird
*   Magic

будзе ператворана ў:

<ul>
<li>Bird</li>
<li>Magic</li>
</ul>

Але гэта:

*   Bird

*   Magic

будзе ператворана ў:

<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>

Элементы спісу могуць утрымліваць некалькі абзацаў, і абзацы пад кожным пунктам павінны мець водступ на 4 прабелы або 1 табуляцыю:

1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.

Гэта выглядае нашмат лепш, калі зрабіць водступ у кожным радку, вядома, зноў жа, калі вам лянота, Markdown таксама дазваляе:

*   This is a list item with two paragraphs.

    This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.

*   Another item in the same list.

Калі вы хочаце змясціць спасылку ў элемент спісу, тады > Трэба зрабіць водступ:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Калі вы хочаце змясціць блок кода, у блоку трэба зрабіць водступдвойчы, што складае 8 прабелаў або 2 табуляцыі:

*   一列表项包含一个列表区块：

        <代码写在这>

Вядома, спіс элементаў можа быць створаны выпадкова, прыкладна так:

1986. What a great season.

Іншымі словамі, ён з'яўляецца ў пачатку радканумар-кропка-прабел, каб пазбегнуць гэтага, вы можаце дадаць зваротную касую рысу перад кропкай.

1986\. What a great season.

代码 区块

Звязаны з праграмай напісанне або зыходны код мовы тэгаў звычайна мае ўжо набраныя блокі кода. Звычайна мы не жадаем, каб гэтыя блокі набіраліся ў выглядзе агульных файлаў абзацаў, а адлюстроўвалі іх такімі, якія яны ёсць. Markdown будзе выкарыстоўваць <pre> 和 <code> тэгі для абгортвання блокаў кода.

Будаўнічыя блокі кода ў Markdown так жа проста, як водступ 4 прабелаў або 1 табуляцыі, напрыклад, увядзіце наступнае:

这是一个普通段落：

    这是一个代码区块。

Markdown пераўтворыцца ў:

<p>这是一个普通段落：</p>

<pre><code>这是一个代码区块。
</code></pre>

Гэты водступ першага парадку на радок (4 прабелы або 1 табуляцыя) выдаляецца, напрыклад:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

будзе ператворана ў:

<p>Here is an example of AppleScript:</p>

<pre><code>tell application "Foo"
    beep
end tell
</code></pre>

Блок кода працягваецца да радка без водступу (або да канца файла).

Унутры блока кода, & , < 和 > Ён будзе аўтаматычна пераўтвораны ў аб'екты HTML, што дазваляе вам вельмі лёгка выкарыстоўваць Markdown для ўстаўкі зыходнага кода HTML для прыкладу, проста скапіруйце і ўстаўце яго, дадайце водступ, а астатняя частка Markdown справіцца з гэтым за вас, напрыклад:

    <div class="footer">
        © 2004 Foo Corporation
    </div>

будзе ператворана ў:

<pre><code><div class="footer">
    &copy; 2004 Foo Corporation
</div>
</code></pre>

У блоку кода агульны сінтаксіс Markdown не будзе пераўтвораны, напрыклад, зорачкі - гэта проста зорачкі, што азначае, што вы можаце лёгка пісаць файлы, звязаныя з сінтаксісам Markdown, у сінтаксісе Markdown.

Дзельнік

你 可以 在 一行 中用 三个 以上 的 星 号 、 减号 、 底线 建立 一个 一个 分隔线 ， 行 内 不能 有 其他 其他 东西。 你 也 可以 可以 在 星 星 号 或是 减号 中间 插入 插入 空格。 下面 每种 写法 写法 都 可以 建立 建立分隔线:

* * *

***

*****

- - -

---------------------------------------

элемент секцыі

спасылка

Markdown падтрымлівае дзве формы сінтаксісу спасылак: У радку和Даведкадзве формы.

У любым выпадку тэкст спасылкі пазначаны [квадратнымі дужкамі].

стварыць аУ радкуКалі вы жадаеце дадаць тэкст загалоўка спасылкі, проста ўключыце тэкст загалоўка ў двукоссе пасля URL, напрыклад:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

Будуць вырабляць:

<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>

<p><a href="http://example.net/">This link</a> has no
title attribute.</p>

Калі вы спасылаецеся на рэсурсы на адным хасце, вы можаце выкарыстоўваць адносныя шляхі:

See my [About](/about/) page for details.

ДаведкаСпасылка суправаджаецца яшчэ адной квадратнай дужкай пасля дужкі тэксту спасылкі, а знак, які выкарыстоўваецца для ідэнтыфікацыі спасылкі, павінен быць запоўнены ў другой квадратнай дужцы:

This is [an example][id] reference-style link.

Вы таксама можаце паставіць прабел паміж двума квадратнымі дужкамі:

This is [an example] [id] reference-style link.

Затым у любым месцы файла вы можаце вызначыць змест спасылкі гэтага тэга:

[id]: http://example.com/  "Optional Title Here"

Змест спасылкі вызначаецца ў выглядзе:

• Квадратныя дужкі (неабавязкова перад трыма прабеламі для водступу), у якія ўводзіцца тэкст спасылкі
• пасля двукроп'я
• пасля аднаго або некалькіх прабелаў або табуляцыі
• URL наступнай спасылкі
• Неабавязкова сачыце за зместам загалоўка, які можа быць заключаны ў адзінарныя двукоссе, падвойныя двукоссе або круглыя ​​дужкі

Вызначэнні наступных трох спасылак аднолькавыя:

[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

асцярожнасць:Існуе вядомая праблема, з-за якой Markdown.pl 1.0.1 ігнаруе загалоўкі спасылак, узятыя ў двукоссе.

URL-адрасы спасылак таксама могуць быць заключаны ў вуглавыя дужкі:

[id]: <http://example.com/>  "Optional Title Here"

Вы таксама можаце змясціць атрыбут title у наступным радку або дадаць водступ, які будзе выглядаць лепш, калі URL занадта доўгі:

[id]: http://example.com/longish/path/to/resource/here
    "Optional Title Here"

Вызначэнне URL выкарыстоўваецца толькі пры стварэнні спасылкі і не адлюстроўваецца непасрэдна ў файле.

Тэгі ідэнтыфікацыі спасылак могуць утрымліваць літары, лічбы, прабелы і знакі прыпынку, але не змяшчаюцьНеЁн адчувальны да рэгістра, таму наступныя дзве спасылкі аднолькавыя:

[link text][a]
[link text][A]

Тэг няяўнай спасылкіФункцыя дазваляе вам не ўказваць тэг спасылкі. У гэтым выпадку тэг спасылкі будзе разглядацца як эквівалент тэксту спасылкі. Каб выкарыстоўваць тэг няяўнай спасылкі, проста дадайце пустую квадратную дужку пасля тэксту спасылкі. Калі вы хочаце "Google " Спасылка на google.com, вы можаце спрасціць:

[Google][]

Затым вызначыце змест спасылкі:

[Google]: http://google.com/

Паколькі тэкст спасылкі можа ўтрымліваць прабелы, гэтая спрошчаная разметка можа ўтрымліваць некалькі слоў:

Visit [Daring Fireball][] for more information.

Затым перайдзіце да вызначэння спасылкі:

[Daring Fireball]: http://daringfireball.net/

Вызначэнне спасылкі можна размясціць у любым месцы файла. Я аддаю перавагу размяшчаць яго непасрэдна пасля абзаца, дзе з'яўляецца спасылка. Вы таксама можаце размясціць яго ў канцы файла, як каментар.

Вось прыклад даведачнай спасылкі:

I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].

  [1]: http://google.com/        "Google"
  [2]: http://search.yahoo.com/  "Yahoo Search"
  [3]: http://search.msn.com/    "MSN Search"

Калі вы зменіце яго, каб выкарыстоўваць назву спасылкі для запісу:

I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].

  [google]: http://google.com/        "Google"
  [yahoo]:  http://search.yahoo.com/  "Yahoo Search"
  [msn]:    http://search.msn.com/    "MSN Search"

Вышэйзгаданыя два спосабы запісу дадуць наступны HTML.

<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>

Ніжэй прыведзены для параўнання файл Markdown з такім жа зместам, запісаны ў радку:

I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").

Насамрэч, сэнс спасылак у стылі спасылак не ў тым, што іх лягчэй пісаць, а ў тым, што іх лягчэй чытаць.Параўнайце прыведзены вышэй прыклад.Сам артыкул у стылі спасылак змяшчае ўсяго 81 сімвал, але ўбудаваная форма павялічыцца да 176 сімвалаў. , калі ён напісаны ў чыстым фармаце HTML, будзе 234. У фармаце HTML тэгаў больш, чым тэксту.

Выкарыстанне спасылак у стылі спасылак Markdown можа зрабіць дакумент больш падобным на канчатковы вынік браўзера, дазваляючы перамяшчаць некаторыя метаданыя, звязаныя з разметкай, за межы тэксту абзаца, і вы можаце дадаваць спасылкі, не прымушаючы артыкул чытаць.

强调

Markdown выкарыстоўвае зорачкі (*) і ніжні радок (_) у якасці сімвала для абазначэння падкрэсленага слова, ёсць * Або _ Словы ў атачэнні ператвараюцца ў <em> акружаны этыкеткамі, з двума * Або _Калі ён загорнуты, ён будзе ператвораны ў <strong>, Напрыклад:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

ператворыцца ў:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Вы можаце выкарыстоўваць любы стыль, які вам падабаецца, адзінае абмежаванне заключаецца ў тым, што вы можаце выкарыстоўваць сімвал для адкрыцця тэга і сімвал для яго завяршэння.

Націск можна таксама ўставіць непасрэдна ў сярэдзіне тэксту:

un*frigging*believable

алекалі ваша * 和 _ Калі з абодвух бакоў ёсць прабелы, яны разглядаюцца як звычайныя сімвалы.

Каб уставіць звычайныя зорачкі або падкрэсліванне непасрэдна перад і пасля тэксту, вы можаце выкарыстоўваць зваротныя касыя рысы:

\*this text is surrounded by literal asterisks\*

Кодэкс

Калі вы хочаце адзначыць невялікі фрагмент убудаванага кода, вы можаце абгарнуць яго зваротнымі сцяжкамі (`), напрыклад:

Use the `printf()` function.

Будуць вырабляць:

<p>Use the <code>printf()</code> function.</p>

Калі вы хочаце ўставіць зваротныя сцяжкі ў раздзел кода, вы можаце пачаць і скончыць раздзел кода некалькімі зваротнымі сцяжкамі:

``There is a literal backtick (`) here.``

Гэты сінтаксіс стварае:

<p><code>There is a literal backtick (`) here.</code></p>

Вы можаце паставіць прабел у пачатку і ў канцы раздзела кода, адзін пасля пачатку і адзін перад канцом, так што вы можаце ўставіць зваротныя галачкі ў пачатку раздзела:

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

Будуць вырабляць:

<p>A single backtick in a code span: <code>`</code></p>

<p>A backtick-delimited string in a code span: <code>`foo`</code></p>

Унутры раздзела кода,& і вуглавыя дужкі都будзе аўтаматычна пераўтвораны ў аб'екты HTML, што палягчае ўстаўку зыходнага кода HTML, Markdown паставіць наступны абзац:

Please don't use any `<blink>` tags.

да:

<p>Please don't use any <code><blink></code> tags.</p>

Вы таксама можаце напісаць гэта:

`—` is the decimal-encoded equivalent of `—`.

Вырабляць:

<p><code>&#8212;</code> is the decimal-encoded
equivalent of <code>&mdash;</code>.</p>

图片

Відавочна, што складана распрацаваць "натуральны" сінтаксіс для ўстаўкі малюнкаў у толькі тэкставае прыкладанне.

Markdown выкарыстоўвае сінтаксіс, падобны да спасылак, для разметкі малюнкаў, а таксама дазваляе два стылі: У радку和Даведка.

Сінтаксіс убудаванага малюнка выглядае так:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

Падрабязнасці наступныя:

• клічнік !
• 一个 方 括号 ， 里面 放上 图片 的 替代 文字
• За гэтым ідуць звычайныя дужкі з URL-адрасам выявы і, нарэшце, неабавязковы тэкст «назвы», узяты ў двукоссе.

Сінтаксіс эталоннага малюнка выглядае так:

![Alt text][id]

"id" - гэта назва спасылкі на выяву, якая вызначаецца гэтак жа, як і спасылка:

[id]: url/to/image  "Optional title attribute"

Пакуль у Markdown няма магчымасці пазначыць шырыню і вышыню выявы, пры неабходнасці вы можаце выкарыстоўваць звычайны <img> этыкетка.

其它

аўтаматычная спасылка

Markdown падтрымлівае апрацоўку URL-адрасоў і паштовых скрынь электроннай пошты ў выглядзе адносна кароткіх аўтаматычных спасылак.Пакуль яны заключаны ў вуглавыя дужкі, Markdown аўтаматычна пераўтворыць іх у спасылку.Тэкст спасылкі агульнага URL такі ж, як і адрас спасылкі, напрыклад:

<http://example.com/>

Уцэнка будзе ператворана ў:

<a href="http://example.com/">http://example.com/</a>

Аўтаматычнае звязванне адрасоў электроннай пошты таксама вельмі падобнае, за выключэннем таго, што Markdown спачатку выканае працэс пераўтварэння кадзіроўкі, пераўтвараючы тэкставыя сімвалы ў шаснаццатковыя аб'екты HTML.Гэты фармат можа падмануць некаторых дрэнных робатаў збору адрасоў электроннай пошты, такіх як:

<[email protected]>

Уцэнка ператворыцца ў:

<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>

У браўзеры гэты радок (фактычна <a href="mailto:[email protected]">[email protected]</a>) становіцца спасылкай «[email protected]», якую можна націснуць.

(Хоць такі падыход можа падмануць шмат робатаў, ён не можа спыніць іх усіх, але гэта лепш, чым нічога. У любым выпадку, адкрыццё вашай паштовай скрыні ў канчатковым выніку прыцягне рэкламныя лісты.)

зваротная касая рыса

Markdown можа выкарыстоўваць зваротныя касыя рысы для ўстаўкі сімвалаў, якія маюць іншыя значэнні ў граматыцы, напрыклад: калі вы хочаце дадаць зорачку побач з тэкстам для вылучэння (але не <em> тэг), перад зорачкай можна паставіць зваротную касую рысу:

\*literal asterisks\*

Націсніце на старонку "Markdown":

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

Бясплатны рэдактар ​​Markdown

Платформа Windows

• MarkdownPad
• MarkPad

Платформа Mac

• мяккі

онлайн рэдактар

• Рэдактар ​​MP

убудова для браўзэра

• Убудова Markdown here

*** Калі можна парэкамендаваць лепшы бясплатны рэдактар ​​Markdown, звярніце ўвагу на водгукіЧэнь Вэйлян,дзякуй!