Co oznacza przecena? Jak korzystać ze składni/znaczników formatowania Markdown?

Obniżka cenCo znaczy?

Jak korzystać ze składni/znaczników formatowania Markdown?

概述

Markdown to lekki język znaczników stworzony przez Johna Grubera.

Pozwala ludziom "pisać dokumenty w formacie zwykłego tekstu, który jest łatwy do czytania i pisania, a następnie konwertować je na prawidłowe dokumenty XHTML (lub HTML)".

Język zawiera wiele funkcji znaczników zwykłego tekstu, które można już znaleźć w wiadomościach e-mail.

John Gruber stworzył język Markdown w 2004 roku, we współpracy z Aaronem Swartzem, w dużej mierze nad składnią.Celem języka jest użycie „formatu zwykłego tekstu, który jest łatwy do odczytania, łatwy do pisania i opcjonalnie konwertowany do prawidłowego XHTML (lub HTML)”.

zamiar

Celem Markdown jest bycie „łatwym do czytania i łatwego pisania”.

czytelność, zrób to mimo wszystko网络 营销, doświadczenie użytkownika jest bardzo ważne.

Plik napisany w Markdown powinien dać się opublikować bezpośrednio w postaci zwykłego tekstu i nie powinien składać się z wielu znaczników lub dyrektyw formatujących.

Na składnię Markdown wpływają niektóre istniejące formaty tekstu na HTML, w tym Setext, atx, Textile, reStructuredText, Grutatext i EtText, ale największym źródłem inspiracji jest format wiadomości e-mail w postaci zwykłego tekstu.

Krótko mówiąc, składnia Markdown składa się z symboli, które są starannie dobrane, a ich funkcje są jasne na pierwszy rzut oka.Na przykład: umieść gwiazdki wokół tekstu, aby wyglądał jak *nacisk*.

Listy w Markdown wyglądają jak, no cóż, listy. Cytaty blokowe w Markdown naprawdę wyglądają jak cytowanie fragmentu tekstu, tak jak w e-mailach.

Kompatybilny z HTML

Celem gramatyki Markdown jest bycie językiem pisania w sieci.

Markdown nie ma na celu zastąpienia HTML, ani nawet się do niego zbliży, ma bardzo niewiele typów składni i odpowiada tylko niewielkiemu podzbiorowi znaczników HTML. Markdown nie został stworzony, aby ułatwić pisanie dokumentów HTML.

Moim zdaniem HTML jest już łatwy do napisania. Ideą Markdown jest ułatwienie czytania, pisania i zmieniania dokumentów do woli. HTML to format publikacji, Markdown toCopywritingpisemny format.W związku z tym składnia formatowania Markdown obejmuje tylko to, co może być zwykłym tekstem.

Tagi, których nie obejmuje Markdown, można zapisać w HTML bezpośrednio w dokumenciePromocja w sieciKopiuj.Nie ma potrzeby oznaczania tego jako HTML lub Markdown, wystarczy dodać znacznik bezpośrednio.

Tylko niektóre elementy blokowe HTML, które mają być ograniczone, takie jak <div>,<table>,<pre>,<p> i inne znaczniki, muszą być oddzielone od innych obszarów zawartości pustymi liniami przed i po, a ich otwierające i zamykające znaczniki nie mogą być wcięte tabulatorami ani spacjami. Generator Markdown jest na tyle sprytny, że nie dodaje niepotrzebnych tagów bloku HTML <p> etykieta.

Przykład wygląda następująco, dodając tabelę HTML do pliku Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Pamiętaj, że składnia formatowania Markdown między tagami bloku HTML nie będzie przetwarzana.Na przykład, jeśli używasz stylu Markdown wewnątrz bloków HTML*强调*nie przyniesie efektu.

Tagi sekcji HTML (wbudowane), takie jak <span>,<cite>,<del> Może być swobodnie używany w akapitach, listach lub nagłówkach Markdown.Zgodnie z osobistymi nawykami możesz nawet używać znaczników HTML do formatowania bez użycia formatu Markdown.Przykład: jeśli wolisz HTML <a> 或 <img> tagi, których można używać bezpośrednio bez linku lub składni tagów obrazu dostarczonej przez Markdown.

W przeciwieństwie do tagów bloku HTML, składnia Markdown jest prawidłowa pomiędzy tagami sekcji HTML.

Automatyczna konwersja znaków specjalnych

W plikach HTML występują dwa znaki, które wymagają specjalnej obsługi: < I & . < symbole są używane do tagów startowych,& Symbole służą do oznaczania encji HTML, jeśli chcesz tylko wyświetlić prototyp tych znaków, musisz użyć formularza encji, na przykład < I &.

& Znaki są szczególnie męczące dla autorów dokumentów internetowych, jeśli zamierzasz wpisać „AT&T", musisz napisać"AT&T”.podczas gdy w adresie URL & Znaki są również konwertowane.Na przykład chcesz połączyć się z:

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

Musisz napisać konwersję adresu URL jako:

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

do umieszczenia w tagu link href we właściwościach.Nie trzeba dodawać, że jest to łatwe do zignorowania i prawdopodobnie największa liczba błędów wykrytych przez walidację standardów HTML.

Markdown umożliwia naturalne pisanie znaków i dba o to, co należy przekonwertować.Jeśli użyjesz & Znak jest częścią encji znaku HTML, pozostaje taki, jak jest, w przeciwnym razie jest konwertowany na &;.

Więc jeśli chcesz wstawić symbol praw autorskich do dokumentu ©, Możesz pisać:

©

Markdown pozostawi go nietkniętym.A jeśli napiszesz:

AT&T

Markdown przekonwertuje go na:

AT&T

Podobna sytuacja występuje również w < notacji, ponieważ Markdown pozwala na zgodność z HTML, jeśli umieścisz < Symbole są używane jako ograniczniki dla tagów HTML, a Markdown nie wykona na nich żadnych konwersji, ale jeśli napiszesz:

4 < 5

Markdown przekonwertuje go na:

4 < 5

Należy jednak zauważyć, że w zakresie kodu, niezależnie od tego, czy jest on wbudowany, czy blokowy, < I & oba symbolena pewnosą konwertowane na encje HTML, funkcja, która pozwala łatwo pisać kod HTML w Markdown (w przeciwieństwie do HTML, gdzie umieszczasz wszystkie < I & Wszystkie są konwertowane na encje HTML, w celu zapisania kodu HTML w pliku HTML. )

element blokowy

Akapity i łamanie wierszy

Akapit Markdown składa się z jednego lub więcej kolejnych wierszy tekstu, poprzedzonych i poprzedzonych więcej niż jedną pustą linią (definicją pustej linii jest to, że wydaje się ona być pusta na ekranie i jest uważana za pustą. Na przykład , jeśli wiersz zawiera tylko spacje i tabulatory, wiersz będzie również traktowany jako pusta linia).Zwykłe akapity nie powinny być wcinane spacjami ani tabulatorami.

Wyrażenie „składa się z jednego lub więcej kolejnych wierszy tekstu” w rzeczywistości oznacza, że ​​Markdown zezwala na wymuszone nowe wiersze (wstawianie nowych wierszy) w akapitach, co różni się od większości innych formatów tekstu na HTML (w tym typu Movable „Konwertuj podziały wierszy „opcja), inne formaty skonwertują każdy podział wiersza na <br /> etykieta.

如果 你w rzeczy samejChcesz polegać na Markdown podczas wstawiania <br /> W przypadku etykiet naciśnij co najmniej dwie spacje w miejscu wstawiania, a następnie naciśnij klawisz Enter.

Rzeczywiście, potrzeba trochę więcej pracy (dodatkowe przestrzenie), aby wygenerować <br /> , ale po prostu „każdy znak nowej linii jest konwertowany na <br />„Metoda nie jest odpowiednia w Markdown, em w MarkdownaiCytaty blokowe w stylu L i listy wieloakapitowe są nie tylko bardziej przydatne, ale także łatwiejsze do odczytania podczas składu z podziałem wierszy.

Tytuł

Markdown obsługuje dwie składnie nagłówków: setekstową i atx.

Forma podobna do ustalonego tekstu to forma z dolnym wierszem, przy użyciu = (najwyższy tytuł) i - (Nagłówki drugiego rzędu), na przykład:

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

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

każda ilość = I - może być skuteczny.

Forma podobna do Atx wstawia od 1 do 6 na początku wiersza # , odpowiadające pozycjom 1–6, na przykład:

# 这是 H1

## 这是 H2

###### 这是 H6

Możesz opcjonalnie "zamknąć" nagłówki w stylu atx, jest to czysto estetyczne, jeśli czujesz się w ten sposób komfortowo, możesz dodać to na końcu wiersza #, podczas gdy końcówki linii # Numer nie musi być taki sam jak początek (liczba znaków na początku wiersza określa kolejność tytułu):

# 这是 H1 #

## 这是 H2 ##

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

Cytaty blokowe Cytaty blokowe

Cytaty blokowe znaczników Markdown są używane podobnie do tych używanych w wiadomościach e-mail > cytatów.Jeśli znasz cytaty w listach e-mail, wiesz, jak utworzyć cytat blokowy w pliku Markdown, który wygląda tak, jakbyś sam łamał wiersze, a następnie dodaj > :

> 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 pozwala również na lenistwo i dodawanie tylko pierwszej linii całego akapitu > :

> 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.

Odniesienia do bloków można zagnieżdżać (np.: odniesienia w odniesieniach), dodając inną liczbę > :

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

W blokach cytowanych można również używać innych składni Markdown, w tym nagłówków, list, bloków kodu itp.:

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

Każdy przyzwoity edytor tekstu może z łatwością tworzyć cytaty w stylu e-mail.Na przykład w BBEdit możesz zaznaczyć tekst, a następnie wybrać z menuzwiększyć hierarchię cytowań.

Lista

Markdown obsługuje zarówno listy uporządkowane, jak i nieuporządkowane.

Listy nieuporządkowane używają gwiazdek, znaków plus lub minus jako znaczników listy:

*   Red
*   Green
*   Blue

Równoważny:

+   Red
+   Green
+   Blue

Równoważny również do:

-   Red
-   Green
-   Blue

Listy uporządkowane zawierają liczby, po których następuje kropka:

1.  Bird
2.  McHale
3.  Parish

Należy pamiętać, że liczby użyte w tagu listy nie mają wpływu na wyjściowy kod HTML. Wynikowe znaczniki HTML dla powyższej listy to:

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

Jeśli znacznik Twojej listy jest zapisany jako:

1.  Bird
1.  McHale
1.  Parish

lub nawet:

3. Bird
1. McHale
8. Parish

Oboje otrzymacie dokładnie to samo wyjście HTML.Chodzi o to, że możesz sprawić, by numery listy w pliku Markdown były takie same, jak wyniki wyjściowe, lub jeśli jesteś leniwy, nie musisz w ogóle dbać o poprawność liczb.

Jeśli używasz leniwego pisania, zaleca się zacząć od 1. dla pierwszego elementu, ponieważ Markdown może w przyszłości obsługiwać atrybut początkowy uporządkowanych list.

Znacznik elementu listy jest zwykle umieszczany po lewej stronie, ale może być wcięty do 3 spacji, a po znaczniku elementu musi następować co najmniej jedna spacja lub tabulator.

Aby lista wyglądała ładniej, możesz uporządkować zawartość ze stałym wcięciem:

*   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.

Ale jeśli jesteś leniwy, to też dobrze:

*   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.

Jeśli elementy listy są oddzielone pustymi wierszami, Markdown użyje zawartości elementów podczas wyprowadzania kodu HTML. <p> Etykiety są pakowane np.:

*   Bird
*   Magic

zostanie przekonwertowany na:

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

Ale to:

*   Bird

*   Magic

zostanie przekonwertowany na:

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

Elementy listy mogą zawierać wiele akapitów, a akapity pod każdym elementem muszą być wcięte o 4 spacje lub 1 tabulator:

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.

Wygląda o wiele lepiej, jeśli wciśniesz każdą linię, oczywiście znowu, jeśli jesteś leniwy, Markdown pozwala również:

*   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.

Jeśli chcesz umieścić odwołanie w elemencie listy, to > Musi być wcięty:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Jeśli chcesz umieścić blok kodu, blok musi być wcięty两次, czyli 8 spacji lub 2 tabulatory:

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

        <代码写在这>

Oczywiście lista przedmiotów może zostać wygenerowana przypadkowo, coś takiego:

1986. What a great season.

Innymi słowy, pojawia się na początku liniiliczba-okres-pusta, aby tego uniknąć, możesz dodać ukośnik odwrotny przed kropką.

1986\. What a great season.

blok kodu

Związany z programem kod źródłowy języka pisania lub języka znaczników zwykle ma już złożone bloki kodu.Zazwyczaj nie chcemy, aby te bloki były składane w sposób, w jaki są one składane w ogólnych plikach akapitowych, ale wyświetlają je tak, jak są. Markdown użyje <pre> I <code> znaczniki do owijania bloków kodu.

Budowanie bloków kodu w Markdown jest tak proste, jak wcięcie 4 spacji lub 1 tabulatora, na przykład wprowadź:

这是一个普通段落：

    这是一个代码区块。

Markdown zostanie przekonwertowany na:

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

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

To wcięcie pierwszego rzędu na wiersz (4 spacje lub 1 tabulator) jest usuwane, na przykład:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

zostanie przekonwertowany na:

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

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

Blok kodu trwa aż do wiersza bez wcięcia (lub końca pliku).

Wewnątrz bloku kodu, & , < I > Zostanie on automatycznie przekonwertowany na encje HTML. Ta metoda bardzo ułatwia używanie Markdown do wstawiania kodu źródłowego HTML dla przykładu, po prostu skopiuj go i wklej, dodaj wcięcie, a reszta Markdown zajmie się tym za Ciebie, dla przykład:

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

zostanie przekonwertowany na:

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

W bloku kodu ogólna składnia Markdown nie zostanie przekonwertowana, na przykład gwiazdki są tylko gwiazdkami, co oznacza, że ​​można łatwo pisać pliki związane ze składnią Markdown w składni Markdown.

linia dzieląca

Możesz użyć więcej niż trzech gwiazdek, znaków minus, podkreśleń w wierszu, aby utworzyć separator, nic więcej w wierszu.Możesz także wstawić spacje między gwiazdkami lub znakami minusa.Każdy z poniższych zapisów może utworzyć dzielnik:

* * *

***

*****

- - -

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

element przekroju

połączyć

Markdown obsługuje dwie formy składni linków: W liniiIOdniesieniedwie formy.

Tak czy inaczej, tekst linku jest oznaczony [nawiasami kwadratowymi].

stworzyćW liniiJeśli chcesz dodać tekst tytułu linku, po prostu umieść tekst tytułu w podwójnych cudzysłowach po adresie URL, na przykład:

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

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

Będzie produkować:

<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>

Jeśli łączysz się z zasobami na tym samym hoście, możesz użyć ścieżek względnych:

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

OdniesieniePo łączu następuje kolejny nawias kwadratowy po nawiasie w tekście linku, a oznaczenie służące do identyfikacji linku należy wypełnić w drugim nawiasie kwadratowym:

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

Możesz również opcjonalnie umieścić spację między dwoma nawiasami kwadratowymi:

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

Następnie w dowolnym miejscu pliku możesz zdefiniować zawartość linku tego tagu:

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

Treść linku definiowana jest w postaci:

• Nawiasy kwadratowe (opcjonalnie poprzedzone maksymalnie trzema spacjami na wcięcie), w które wprowadzany jest tekst linku
• po którym następuje dwukropek
• po którym następuje co najmniej jedna spacja lub tabulator
• adres URL następnego linku
• Opcjonalnie postępuj zgodnie z treścią tytułu, która może być ujęta w pojedyncze cudzysłowy, podwójne cudzysłowy lub nawiasy

Definicje poniższych trzech linków są takie same:

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

Uwaga:Znany jest problem polegający na tym, że Markdown.pl 1.0.1 ignoruje tytuły linków ujęte w pojedyncze cudzysłowy.

Adresy URL linków można również umieścić w nawiasach ostrych:

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

Możesz również umieścić atrybut title w następnym wierszu lub dodać wcięcie, które będzie wyglądać lepiej, jeśli adres URL jest zbyt długi:

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

Definicja adresu URL jest używana tylko podczas generowania linku i nie pojawia się bezpośrednio w pliku.

Tagi identyfikujące łącze mogą zawierać litery, cyfry, spacje i znaki interpunkcyjne, ale nieNieWielkość liter jest rozróżniana, więc następujące dwa linki są takie same:

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

Niejawny tag linkupozwala pominąć określanie tagu linku. W takim przypadku tag linku będzie traktowany jako odpowiednik tekstu linku. Aby użyć tagu linku niejawnego, po prostu dodaj pusty nawias kwadratowy po tekście linku. Jeśli chcesz, aby „Google „ Łącząc się z witryną google.com, możesz uprościć:

[Google][]

Następnie zdefiniuj treść linku:

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

Ponieważ tekst linku może zawierać spacje, ten uproszczony znacznik może zawierać wiele słów:

Visit [Daring Fireball][] for more information.

Następnie przejdź do zdefiniowania linku:

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

Definicję linku można umieścić w dowolnym miejscu w pliku, wolę umieścić ją bezpośrednio po akapicie, w którym pojawia się link.Można też umieścić ją na końcu pliku, tak jak komentarz.

Oto przykład linku referencyjnego:

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"

Jeśli zmienisz to, aby używać nazwy linku do pisania:

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"

Powyższe dwa sposoby pisania dadzą następujący kod 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>

Poniżej znajduje się plik Markdown o tej samej treści napisany inline, dostarczony do porównania:

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").

W rzeczywistości celem linków w stylu referencyjnym nie jest to, że łatwiej jest pisać, ale łatwiej jest czytać.Porównaj powyższy przykład.Sam artykuł w stylu referencyjnym ma tylko 81 znaków, ale formularz w tekście wzrośnie do 176 znaków, jeśli jest napisany w czystym formacie HTML, będzie to 234. W formacie HTML jest więcej tagów niż tekstu.

Korzystając z łączy Markdown w stylu odwołań, możesz upodobnić dokument do końcowego wyniku przeglądarki, umożliwiając przeniesienie niektórych metadanych związanych ze znacznikami poza tekst akapitu, a także możesz dodawać łącza bez odczuwania czytania artykułu. .

强调

Markdown używa gwiazdek (*) i dolny wiersz (_) jako symbol oznaczający podkreślone słowo, jest * 或 _ Słowa otoczone są konwertowane na <em> otoczony etykietami, z dwoma * 或 _Jeśli jest zapakowany, zostanie zamieniony na <strong>,Na przykład:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

zamieni się w:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Możesz użyć dowolnego stylu, jedynym ograniczeniem jest to, że możesz otworzyć tag, którym chcesz go zakończyć.

Wyróżnienie można również wstawić bezpośrednio w środku tekstu:

un*frigging*believable

aleJeżeli twój * I _ Jeśli po obu stronach są białe znaki, są one traktowane jak normalne symbole.

Aby wstawić normalne gwiazdki lub podkreślenia bezpośrednio przed i po tekście, możesz użyć odwrotnych ukośników:

\*this text is surrounded by literal asterisks\*

kod

Jeśli chcesz oznaczyć mały fragment kodu wbudowanego, możesz zawinąć go w backticki (`),Np:

Use the `printf()` function.

Będzie produkować:

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

Jeśli chcesz wstawić backticks wewnątrz sekcji kodu, możesz rozpocząć i zakończyć sekcję kodu wieloma backtickami:

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

Ta składnia daje:

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

Możesz wstawić spację na początku i na końcu sekcji kodu, jeden po początku i jeden przed końcem, dzięki czemu możesz wstawić backticks na początku sekcji:

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

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

Będzie produkować:

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

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

Wewnątrz sekcji kodu,& i kątowniki都zostanie automatycznie przekonwertowany na encje HTML, co ułatwia wstawianie kodu źródłowego HTML, Markdown umieści następujący akapit:

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

do:

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

Możesz też napisać to:

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

Produkować:

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

图片

Oczywiście trudno jest zaprojektować „naturalną” składnię do wstawiania obrazów w aplikacji tekstowej.

Markdown używa składni podobnej do składni linków do oznaczania obrazów, a także dopuszcza dwa style: W liniiIOdniesienie.

Wbudowana składnia obrazu wygląda następująco:

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

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

Szczegóły są następujące:

• wykrzyknik !
• a następnie nawiasy kwadratowe z tekstem alternatywnym obrazu
• Po nim następują zwykłe nawiasy z adresem URL obrazu, a na koniec opcjonalny tekst „tytułu” ujęty w cudzysłowy.

Składnia obrazu referencyjnego wygląda tak:

![Alt text][id]

„id” to nazwa odniesienia do obrazu, która jest definiowana w taki sam sposób, jak odniesienia do linku:

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

Jak dotąd Markdown nie ma możliwości określenia szerokości i wysokości obrazu, jeśli potrzebujesz, możesz użyć normalnego <img> etykieta.

其它

automatyczne łącze

Markdown obsługuje przetwarzanie adresów URL i skrzynek pocztowych w postaci stosunkowo krótkich automatycznych linków.O ile są one ujęte w nawiasy kątowe, Markdown automatycznie przekształci je w link.Tekst linku ogólnego adresu URL jest taki sam jak adres linku, na przykład:

<http://example.com/>

Przecena zostanie przekonwertowana na:

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

Automatyczne łączenie adresów e-mail jest również bardzo podobne, z wyjątkiem tego, że Markdown najpierw wykona proces konwersji kodowania, konwertując znaki tekstowe na szesnastkowe jednostki HTML.Ten format może oszukać niektóre złe roboty zbierające adresy e-mail, takie jak:

<[email protected]>

Przecena zmieni się w:

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

W przeglądarce ten ciąg (właściwie <a href="mailto:[email protected]">[email protected]</a>) staje się klikalnym linkiem „[email protected]”.

(Chociaż takie podejście może oszukać wiele robotów, nie powstrzyma ich wszystkich, ale jest lepsze niż nic. W każdym razie otwarcie skrzynki pocztowej w końcu przyciągnie listy reklamowe).

ukośnik wsteczny

Markdown może używać ukośników odwrotnych do wstawiania symboli, które mają inne znaczenia w gramatyce, na przykład: jeśli chcesz dodać gwiazdkę obok tekstu dla podkreślenia (ale nie <em> tag), gwiazdkę można poprzedzić ukośnikiem odwrotnym:

\*literal asterisks\*

Markdown obsługuje następujące symbole poprzedzone odwrotnym ukośnikiem, aby ułatwić wstawianie typowych symboli:

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

Darmowy edytor przecen

Platforma Windowsa

• Pad Markdown
• MarkPad

Platforma Mac

• Mou

edytor online

• MPEditor

dodatek do przeglądarki

• Wtyczka Markdown tutaj

*** Jeśli możesz polecić lepszy darmowy edytor Markdown, zwróć uwagę na opinieChen Weiliang,Dzięki!