Kion signifas Markdown? Kiel uzi Markdown-sintakso/formata markado?

MarkdownKion signifas?

Kiel uzi Markdown-sintakso/formata markado?

Superrigardo

Markdown estas malpeza markadlingvo kreita de John Gruber.

Ĝi permesas al homoj "skribi dokumentojn en simpla teksta formato, kiu estas facile legebla kaj skribi, kaj poste konverti ilin en validajn XHTML (aŭ HTML) dokumentojn".

La lingvo enhavas multajn el la trajtoj de klarteksta markado jam trovitaj en retpoŝto.

John Gruber kreis la Markdown-lingvon en 2004, en kunlaboro kun Aaron Swartz plejparte pri la sintakso.La celo de la lingvo estas uzi "formaton de simpla teksto, kiu estas facile legebla, facile verkebla, kaj laŭvole konverta al valida XHTML (aŭ HTML)".

celo

La celo de Markdown estas esti "facile legebla kaj facile skribi".

legebleco, faru ĝin ĉiukazeInterreta Merkatado, uzanta sperto estas tre grava.

Dokumento skribita en Markdown devus povi esti publikigita rekte en simpla teksto, kaj ne devus ŝajni esti kunmetita de multaj etikedoj aŭ formataj direktivoj.

Markdown-sintakso estas influita de kelkaj ekzistantaj teksto-al-HTML-formatoj, inkluzive de Setext, atx, Textile, reStructuredText, Grutatext, kaj EtText, sed la plej granda fonto de inspiro estas la klarteksta retpoŝta formato.

Resume, la sintakso de Markdown estas tute kunmetita de simboloj, kiuj estas zorge elektitaj kaj iliaj funkcioj estas klaraj je unu ekrigardo.Ekzemple: metu asteriskojn ĉirkaŭ teksto por ke ĝi aspektu kiel *emfazo*.

Listoj en Markdown aspektas kiel, nu, listoj. Blokcitaĵoj en Markdown vere aspektas kiel citado de teksto, same kiel vi vidis en retpoŝtoj.

Kongrua kun HTML

La celo de la Markdown-gramatiko estas esti skriblingvo por la reto.

Markdown ne celas anstataŭigi HTML-on, aŭ eĉ proksimiĝi al ĝi, ĝi havas tre malmulte da sintakso kaj respondas al malgranda subaro de HTML-markado. Markdown ne estis konceptita por igi HTML-dokumentojn pli facile verki.

Miaopinie, HTML jam estas facile verkebla. La ideo de Markdown estas fari dokumentojn pli facile legi, skribi kaj ŝanĝi laŭvole. HTML estas eldonformato, Markdown estas akopiskriboskriba formato.Kiel tia, la formatada sintakso de Markdown nur kovras tion, kion simpla teksto povas.

Etikedoj kiuj ne estas kovritaj de Markdown povas esti skribitaj en HTML rekte en la dokumentoReteja Promociokopio.Ne necesas marki ĉi tion kiel HTML aŭ Markdown; simple aldonu la markadon rekte.

Nur iuj HTML-blokaj elementoj estas limigitaj - kiel ekz <div>,<table>,<pre>,<p> kaj aliaj etikedoj, ili devas esti apartigitaj de aliaj enhavareoj kun malplenaj linioj antaŭ kaj post, kaj iliaj malfermaj kaj fermaj etikedoj ne devas esti indentitaj per langetoj aŭ spacoj. La Markdown-generatoro estas sufiĉe inteligenta por ne aldoni nenecesajn HTML-blokajn etikedojn <p> Etikedo.

La ekzemplo estas kiel sekvas, aldonante HTML-tabelon al la Markdown-dosiero:

这是一个普通段落。

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

这是另一个普通段落。

Notu, ke Markdown-formata sintakso inter HTML-blokaj etikedoj ne estos prilaborita.Ekzemple, se vi uzas Markdown-stilon ene de HTML-bloko*强调*ne havos efikon.

HTML-sekciaj (enliniaj) etikedoj kiel ekzemple <span>,<cite>,<del> Uzeblas libere en Markdown-alineoj, listoj aŭ titoloj.Laŭ personaj kutimoj, vi eĉ povas uzi HTML-etikedojn por formati sen uzi Markdown-formaton.Ekzemplo: Se vi preferas HTML <a> 或 <img> etikedoj, kiuj povas esti uzataj rekte sen la ligilo aŭ bilda etikedsintakso provizita de Markdown.

Male al inter HTML-blokaj etikedoj, Markdown-sintakso validas inter HTML-sekciaj etikedoj.

Aŭtomata konvertiĝo de specialaj signoj

En HTML-dosieroj, estas du signoj kiuj postulas specialan uzadon: < 和 & . < simboloj estas uzataj por komencaj etikedoj,& Simboloj estas uzataj por marki HTML-etojn, se vi nur volas montri la prototipon de ĉi tiuj signoj, vi devas uzi la entan formon, kiel < 和 &.

& Signoj estas precipe turmentaj por retaj dokumentoj, se vi tajpas "AT&T", vi devas skribi "AT&T".dum en la URL & Karakteroj ankaŭ estas konvertitaj.Ekzemple vi volas ligi al:

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

Vi devas skribi la URL-konverton kiel:

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

por esti metita en la ligilo-etikedo href en proprietoj.Ne necesas diri, ke ĉi tio estas facile ignorebla, kaj verŝajne la plej granda nombro da eraroj detektitaj per HTML-normoj validumado.

Markdown permesas vin skribi signojn nature, kaj ĝi prizorgas tion, kio devas esti konvertita.se vi uzas & Signo estas parto de HTML-karaktera ento, ĝi estas lasita tia, alie ĝi estas konvertita al &;.

Do se vi volas enmeti kopirajtan simbolon en la dokumenton ©, vi povas skribi:

©

Markdown lasos ĝin netuŝita.Kaj se vi skribas:

AT&T

Markdown konvertiĝos ĝin al:

AT&T

Simila situacio ankaŭ okazas en < notado, ĉar Markdown permesas HTML-kongruon, se vi metas < Simboloj estas uzataj kiel limigiloj por HTML-etikedoj, kaj Markdown ne faros ajnan konvertiĝon sur ili, sed se vi skribas:

4 < 5

Markdown konvertiĝos ĝin al:

4 < 5

Tamen, oni devas rimarki, ke en la amplekso de kodo, ĉu ĝi estas enlinia aŭ blokita, < 和 & ambaŭ simbolojdevasestas konvertitaj al HTML-unuoj, trajto kiu permesas vin facile skribi HTML-kodon en Markdown (kontraste al HTML, kie vi metas ĉiujn < 和 & Ĉiuj estas konvertitaj en HTML-entaĵojn, por skribi HTML-kodon en la HTML-dosiero. )

blokelemento

Alineoj kaj linio-rompoj

Markdown-alineo konsistas el unu aŭ pluraj sinsekvaj linioj de teksto, antaŭitaj kaj sekvataj de pli ol unu malplena linio (la difino de malplena linio estas ke ĝi ŝajnas malplena sur ekrano kaj estas konsiderata kiel malplena linio. Por ekzemplo, , se linio enhavas nur spacojn kaj langetojn, la linio ankaŭ estos traktata kiel malplena linio).Normalaj alineoj ne devus esti indentitaj per spacoj aŭ langetoj.

La frazo "konsistas el unu aŭ pluraj sinsekvaj linioj de teksto" fakte implicas ke Markdown permesas malvolajn linirompojn (enmeto de novlinioj) ene de alineoj, trajto kiu estas diferenca de la plej multaj aliaj teksto-al-HTML-formatoj (inkluzive de Movable Type "Convert Line". Breaks"), aliaj formatoj konvertiĝos ĉiun linion al <br /> Etikedo.

Se vifakteVolas fidi Markdown por enmeti <br /> Por etikedoj, premu du aŭ pli da spacoj ĉe la enmeta loko kaj poste premu Enter.

Efektive, necesas iom pli da laboro (aldonaj spacoj) por generi <br /> , sed simple "ĉiu novlinio estas konvertita al <br />"La metodo ne taŭgas en Markdown, em en MarkdownaiL-stilaj blokcitaĵoj kaj plurparagrafaj listoj estas ne nur pli utilaj sed ankaŭ pli facile legeblaj dum kompostado per liniorompoj.

Titolo

Markdown subtenas du sintaksojn por titoloj, Setext-simila kaj atx-simila.

La Settext-simila formo estas la formo kun la malsupra linio, uzante = (plej alta titolo) kaj - (Titoloj de dua ordo), ekzemple:

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

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

ajna kvanto = 和 - povas esti efika.

La Atx-simila formo enigas 1 ĝis 6 komence de la linio # , respondante al rubrikoj 1 ĝis 6, ekzemple:

# 这是 H1

## 这是 H2

###### 这是 H6

Vi povas laŭvole "fermi" atx-similajn kapliniojn, ĉi tio estas nur por estetiko, se vi sentas vin komforta tiamaniere, vi povas aldoni ĝin ĉe la fino de la linio. #, dum la linio finiĝas # La nombro ne devas esti la sama kiel la komenco (la nombro da funtaj signoj ĉe la komenco de la linio determinas la ordon de la titolo):

# 这是 H1 #

## 这是 H2 ##

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

Blokcitaĵoj Blokcitaĵoj

Markdown markdown blokcitaĵoj estas uzataj simile al tiuj uzataj en retpoŝto > de citaĵoj.Se vi konas citaĵojn en retpoŝtaj literoj, vi scias kiel krei blokcitaĵon en Markdown-dosiero, kiu aspektus kiel vi mem rompas la liniojn, tiam aldonu. > :

> 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 ankaŭ permesas vin mallabori kaj aldoni nur la unuan linion de la tuta alineo > :

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

Blokaj referencoj povas esti nestitaj (ekz.: referencoj ene de referencoj) aldonante malsaman nombron da > :

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

Aliaj Markdown-sintakso ankaŭ povas esti uzataj ene de cititaj blokoj, inkluzive de titoloj, listoj, kodblokoj ktp.:

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

Ajna deca tekstredaktilo povas facile krei retpoŝtajn citaĵojn.Ekzemple en BBEdit vi povas elekti tekston kaj poste elekti el la menuopliigi citaĵhierarkion.

Listo

Markdown subtenas ordigitajn kaj neordigitajn listojn.

Neordigitaj listoj uzas asteriskojn, plussignojn aŭ minussignojn kiel listsignojn:

*   Red
*   Green
*   Blue

Ekvivalenta al:

+   Red
+   Green
+   Blue

Ankaŭ ekvivalenta al:

-   Red
-   Green
-   Blue

Ordigitaj listoj uzas nombrojn sekvitajn de punkto:

1.  Bird
2.  McHale
3.  Parish

Gravas noti, ke la nombroj, kiujn vi uzas sur la listo-etikedo, ne influas la eligan HTML-on. La rezulta HTML-markado por ĉi-supra listo estus:

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

Se via listo markado estas skribita kiel:

1.  Bird
1.  McHale
1.  Parish

aŭ eĉ:

3. Bird
1. McHale
8. Parish

Vi ambaŭ ricevos ĝuste la saman HTML-eligon.La afero estas, ke vi povas fari la listnombrojn en la Markdown-dosiero samaj kiel la eligrezultoj, aŭ se vi estas maldiligenta, vi tute ne bezonas zorgi pri la ĝusteco de la nombroj.

Se vi uzas maldiligentan skribadon, oni rekomendas komenci per 1. por la unua ero, ĉar Markdown eble subtenos la komencan atributon de ordigitaj listoj estonte.

La listero-etikedo estas kutime metita maldekstren, sed ĝi povas esti indentigita, ĝis 3 spacoj, kaj la itemetikedo devas esti sekvita de almenaŭ unu spaco aŭ langeto.

Por ke la listo aspektu pli agrabla, vi povas organizi la enhavon kun fiksa streko:

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

Sed se vi estas maldiligenta, ankaŭ tio estas bone:

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

Se la listeroj estas apartigitaj per malplenaj linioj, Markdown uzos la eron-enhavon dum eligo de HTML. <p> Etikedoj estas envolvitaj, ekzemple:

*   Bird
*   Magic

estos konvertita al:

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

Sed ĉi tio:

*   Bird

*   Magic

estos konvertita al:

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

Listeroj povas enhavi plurajn alineojn, kaj la alineoj sub ĉiu ero devas esti indentitaj per 4 spacoj aŭ 1 langeto:

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.

Ĝi aspektas multe pli bone se vi ŝovas ĉiun linion, kompreneble, denove, se vi estas maldiligenta, Markdown ankaŭ permesas:

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

Se vi volas meti referencon enen liston, tiam > Ĝi devas esti indentigita:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Se vi volas meti kodblokon, la bloko devas esti indentigitadufoje, kiu estas 8 spacoj aŭ 2 langetoj:

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

        <代码写在这>

Kompreneble, listo de eroj povus esti generita hazarde, io kiel ĉi tio:

1986. What a great season.

Alivorte, ĝi aperas komence de la linionombro-periodo-blanka, por eviti ĉi tion, vi povas aldoni malantaŭan oblikvon antaŭ la periodo.

1986\. What a great season.

kodbloko

Program-rilata skribado aŭ etikedlingva fontkodo kutime havas jam kompostitajn kodblokojn. Kutime, ni ne volas, ke ĉi tiuj blokoj estu kompostitaj kiel ĝeneralaj alineaj dosieroj, sed montru ilin tiaj, kiaj ili estas. Markdown uzos <pre> 和 <code> etikedoj por envolvi kodblokojn.

Konstruaj blokoj de kodo en Markdown estas tiel simpla kiel ŝovi 4 spacojn aŭ 1 langeton, ekzemple, enigu la jenon:

这是一个普通段落：

    这是一个代码区块。

Markdown konvertiĝos al:

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

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

Ĉi tiu unuaorda indentaĵo per linio (4 spacoj aŭ 1 langeto) estas forigita, ekzemple:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

estos konvertita al:

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

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

Bloko de kodo daŭras ĝis la neindentigita linio (aŭ la fino de la dosiero).

Ene de la kodbloko, & , < 和 > Ĝi estos aŭtomate konvertita en HTML-etojn.Ĉi tiu metodo faciligas al vi uzi Markdown por enmeti la HTML-fontkodon por la ekzemplo, simple kopiu kaj algluu ĝin, aldonu deŝovon, kaj la resto Markdown pritraktos ĝin por vi, ĉar ekzemplo:

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

estos konvertita al:

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

En la kodbloko, la ĝenerala Markdown-sintakso ne estos konvertita, kiel asteriskoj estas nur asteriskoj, kio signifas, ke vi povas facile skribi Markdown-sintakso-rilatajn dosierojn en Markdown-sintakso.

dividanto

Vi povas uzi pli ol tri steletojn, minussignojn, substrekojn por krei disigilon en linio, nenion alian en la linio.Vi ankaŭ povas enmeti spacojn inter asteriskoj aŭ minussignoj.Disiglinioj povas esti kreitaj en ĉiu el la sekvaj manieroj de skribo:

* * *

***

*****

- - -

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

sekcia elemento

ligilo

Markdown subtenas du formojn de ligsintakso: En linio和Referencodu formoj.

Ĉiuokaze, ligteksto estas markita per [kvadrataj krampoj].

krei aEn linioSe vi volas aldoni la titoltekston de la ligilo, simple envolvu la titoltekston per duoblaj citiloj post la URL, ekzemple:

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

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

Produktos:

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

Se vi ligas al rimedoj sur la sama gastiganto, vi povas uzi relativajn vojojn:

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

ReferencoLa ligilo estas sekvata de alia kvadrata krampo post la krampo de la ligteksto, kaj la marko uzata por identigi la ligon devas esti plenigita en la dua kvadrata krampo:

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

Vi ankaŭ povas laŭvole meti spacon inter la du kvadrataj krampoj:

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

Tiam, ie ajn en la dosiero, vi povas difini la ligan enhavon de ĉi tiu etikedo:

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

Ligenhavo estas difinita en la formo:

• Kvadrataj krampoj (laŭvole antaŭitaj de ĝis tri spacoj por deŝovo) en kiuj ligteksto estas enigita
• sekvata de dupunkto
• sekvata de unu aŭ pluraj spacoj aŭ langetoj
• la URL de la sekva ligilo
• Laŭvole sekvu la titolenhavon, kiu povas esti enfermita per unuopaj citiloj, duoblaj citiloj aŭ krampoj

La difinoj de la sekvaj tri ligiloj estas la samaj:

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

singardemo:Estas konata problemo, kie Markdown.pl 1.0.1 ignoras ligiltitolojn enfermitajn per unuopaj citiloj.

Ligiloj ankaŭ povas esti enfermitaj en angulaj krampoj:

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

Vi ankaŭ povas meti la titolo-atributon sur la sekvan linion, aŭ aldoni iom da deŝovo, kiu aspektos pli bone se la URL estas tro longa:

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

La URL-difino estas uzata nur dum generado de la ligilo, kaj ne aperas rekte en la dosiero.

Ligi-identigetikedoj povas enhavi literojn, ciferojn, blankspacon kaj interpunkcion, sed ne havasNeĜi distingas minusklecon, do la sekvaj du ligiloj estas samaj:

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

Implica ligilo-etikedofunkcio ebligas al vi preterlasi specifi ligilon. En ĉi tiu kazo, la ligilo-etikedo estos traktata kiel ekvivalenta al la ligilo-teksto. Por uzi implican ligilon, simple aldonu malplenan kvadratan krampon post la ligteksto. Se vi volas "Google " Ligante al google.com, vi povas simpligi al:

[Google][]

Tiam difinu la ligan enhavon:

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

Ĉar ligteksto povas enhavi blankspacon, ĉi tiu simpligita markado povas enhavi plurajn vortojn:

Visit [Daring Fireball][] for more information.

Tiam daŭrigu por difini la ligon:

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

La difino de la ligilo povas esti metita ie ajn en la dosiero.Mi preferas meti ĝin rekte post la alineo kie la ligilo aperas.Vi ankaŭ povas meti ĝin fine de la dosiero, same kiel komenton.

Jen ekzemplo de referenca ligo:

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"

Se vi ŝanĝas ĝin por uzi la ligilon por skribi:

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"

La supraj du manieroj skribi produktos la jenan 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>

Malsupre estas Markdown-dosiero de la sama enhavo skribita en linio, provizita por komparo:

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

Fakte, la punkto de referencstilaj ligiloj ne estas ke ili estas pli facile verkeblaj, sed ke ili estas pli facile legeblaj.Komparu la supran ekzemplon.La referencstila artikolo mem havas nur 81 signojn, sed la enlinia formo pliiĝos al 176 signoj. , se ĝi estas skribita en pura HTML-formato, estos 234 signoj. En HTML-formato, estas pli da etikedoj ol teksto.

Uzante la referenc-stilaj ligiloj de Markdown, vi povas fari la dokumenton pli kiel la fina rezulto de la retumilo, ebligante al vi movi iujn markadajn metadatumojn ekster la alinea teksto, kaj vi povas aldoni ligilojn sen fari la legan senton de la artikolo. .

Emfazi

Markdown uzas asteriskojn (*) kaj la malsupra linio (_) kiel simbolo por marki substrekita vorto, estas * 或 _ Ĉirkaŭitaj vortoj estas konvertitaj al <em> ĉirkaŭita de etikedoj, kun du * 或 _Se ĝi estas envolvita, ĝi estos konvertita en <strong>, ekz:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

transformiĝos en:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Vi povas uzi kian ajn stilon vi ŝatas, la sola limigo estas, ke vi povas malfermi la etikedon per kiu simbolo vi volas fini ĝin.

Emfazo ankaŭ povas esti enmetita rekte en la mezo de teksto:

un*frigging*believable

sedse via * 和 _ Se estas blankspacoj ambaŭflanke, ili estas nur traktataj kiel normalaj simboloj.

Por enmeti normalajn asteriskojn aŭ substrekojn rekte antaŭ kaj post teksto, vi povas uzi inversajn oblikvojn:

\*this text is surrounded by literal asterisks\*

Kodo

Se vi volas marki malgrandan pecon de enlinia kodo, vi povas envolvi ĝin per retromarkoj (`), ekz:

Use the `printf()` function.

Produktos:

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

Se vi volas enmeti backticks ene de kodsekcio, vi povas komenci kaj fini la kodsekcion per pluraj backticks:

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

Ĉi tiu sintakso produktas:

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

Vi povas meti blankspacon ĉe la komenco kaj fino de kodsekcio, unu post la komenco kaj unu antaŭ la fino, por ke vi povu enmeti retromarkojn komence de la sekcio:

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

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

Produktos:

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

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

Ene de la koda sekcio,& kaj angulaj krampoj都estos aŭtomate konvertita al HTML-etoj, kio faciligas enmeti HTML-fontkodon, Markdown metos la sekvan alineon:

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

al:

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

Vi ankaŭ povas skribi ĉi tion:

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

Produkti:

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

图片

Evidente, estas malfacile desegni "naturan" sintakson por enmeti bildojn en nurteksta aplikaĵo.

Markdown uzas sintakson similan al ligiloj por marki bildojn, kaj ankaŭ permesas du stilojn: En linio和Referenco.

La enlinia bilda sintakso aspektas jene:

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

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

Detaloj estas kiel sekvas:

• ekkria signo !
• sekvita de kvadrata krampo kun altteksto por la bildo
• Tiam normala krampo, metu la URL de la bildo enen, kaj finfine envolvu ĝin per citiloj kaj aldonu laŭvolan 'titolon' tekston.

La referenca bilda sintakso aspektas jene:

![Alt text][id]

"id" estas la nomo de la bildreferenco, kiu estas difinita en la sama maniero kiel ligreferenco:

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

Ĝis nun, Markdown ne havas manieron specifi la larĝecon kaj altecon de la bildo, se vi bezonas, vi povas uzi la normalan <img> Etikedo.

其它

aŭtomata ligo

Markdown subtenas pretigi URL-ojn kaj retpoŝtojn en formo de mallongaj aŭtomataj ligiloj. Dum ili estas enfermitaj en angulaj krampoj, Markdown aŭtomate konvertos ĝin en ligilon.La ligteksto de ĝenerala URL estas la sama kiel la lig-adreso, ekzemple:

<http://example.com/>

Markdown estos konvertita al:

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

La aŭtomata ligo de retadresoj ankaŭ estas simila, krom ke Markdown unue faros kodan konvertan procezon, konvertante tekstsignojn en deksesumajn HTML-entaĵojn. Ĉi tiu formato povas trompi kelkajn malbonajn retpoŝtadresajn kolektajn robotojn, kiel ekzemple:

<[email protected]>

Markdown fariĝos:

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

En la retumilo, ĉi tiu ĉeno (fakte <a href="mailto:[email protected]">[email protected]</a>) fariĝas klakebla "[email protected]" ligilo.

(Kvankam ĉi tiu aliro povas trompi multajn robotojn, ĝi ne povas haltigi ilin ĉiujn, sed ĝi estas pli bona ol nenio. Ĉiukaze, malfermi vian leterkeston eventuale altiros reklamajn leterojn.)

malantaŭa oblikvo

Markdown povas uzi inversajn oblikvojn por enmeti simbolojn kiuj havas aliajn signifojn en la gramatiko, ekzemple: se vi volas aldoni asteriskon apud la teksto por emfazo (sed ne <em> etikedo), vi povas antaŭi la asteriskon per malantaŭa oblikvo:

\*literal asterisks\*

Markdown subtenas la sekvajn simbolojn antaŭitajn de malantaŭa oblikvo por helpi enigi oftajn simbolojn:

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

Markdown senpaga redaktilo

Vindoza platformo

• MarkdownPad
• MarkPad

Mac-platformo

• Mola

reta redaktilo

• MPEditor

retumilo kromaĵo

• Markdown ĉi tie kromaĵo

*** Se estas pli bona senpaga Markdown-redaktilo por rekomendi, bonvolu atenti pri komentojChen Weiliang,Dankon!