markdown poradnik

Transkrypt

markdown poradnik
MARKDOWNPORADNIK
Markdownskrótowotopoprostujęzykformatowaniatekstu.Cośjakbbcodeczytagi
whtml.JesttoobecnieJEDYNAmożliwośćformatowaniatekstunanovelki.pl.W
przyszłościplanujemywprowadzićinneformaty.
Tutorialmdpolecanydlazielonych:hOp://markdowntutorial.com/(wzupełności
powinienwystarczyćnapoczątek)
Ogólneporady:
1)Dorobieniatekstukursywąużywasię:"*"np.*jakiśpochylonytekst*(nie
powinnostosowaćsię_dotekstupochylonego)
2)Dorobieniatekstupogrubionegoużywasię:"**"np.**jakiśpogrubionytekst**
3)Dorobieniatekstupogrubionegoipochylonegoużywasię"_**"np._**tekst
pogrubionyorazpochylony**_
4)Dotworzenianagłówkówużywasię#
#Pierwszy
Pierwszy(nagłówektytułujestautomatycznie
generowanyprzydodawaniurozdziału)
##Drugi
Drugi
###Trzeci
Trzeci
####Czwarty
Czwarty
#####Piąty
Piąty
######Szósty Szósty
5)Bydodaćlinkaużywamy[tekst](link)np.[VisitGitHub!](www.github.com)
6)Obrazekdodajemyjako![podpis_obrazka](linkdoobrazka)
7)Żebystworzyćblokktórywyróżninamczęśćtekstuużywamy>
>Jakiśprzykładowytekst
8)Żebystworzyćlistęużywamy*,pomiędzygwiazdkąatekstemmusibyćspacja.
Jeślichcemyżebybyłatolistanumerycznaużywamycyfrazaniąkropki.
*Milk
*Eggs
*Salmon
*BuOer
1.Crackthreeeggsoverabowl
2.Pouragallonofmilkintothebowl
3.RubthesalmonvigorouslywithbuOer
4.Dropthesalmonintotheegg-milkbowl
9)Jeślitwojanazwawłasnazawieraznak_tonajlepszymrozwiązaniemjestdodanie
`przednazwą.Np.broń_dwuręcznapoprawniesformatujesięjeślinapiszesztojako
`broń_dwuręczna`
10)Dozrobienianowegoakapituwystarczyżedasz:
jakiśtekst[enter]
[enter]
tekstwnowymakapicie
cowyrenderujecijako:
jakiśtekst
tekstwnowymakapicie
11)Doprzeniesieniasłowadonowejliniitrzebaużyćskładni:
jakiśtekst[spacja][spacja][enter]
tekstwnowejlinii
bądź:
jakiśtekst[enter]
[spacja][spacja]tekstwnowejlinii
cowyrenderujecijako:
jakiśtekst
tekstwnowejlinii
12)Wieleenterówwliniiniejestzaimplementowanewmarkdownie,alesąniektóre
odmianyktórepozwalająuzyskaćtopoprzez:
jakiśtekst[enter]
[spacja][spacja][enter]
[spacja][spacja][enter]
tekstdwielinieniżej
cowyrenderujecijako:
jakiśtekst
tekstdwielinieniżej
13)Tabelęwmarkdownierobisięnastępująco:
|Tables|Are|Cool|
|----------|:-------------:|------:|
|col1is|ler-aligned|$1600|
|col2is|centered|$12|
|col3is|right-aligned|$1|
towyrenderujeciładnątabelęwhtml.Oczywiścietakichtabelniegenerujesz
ręcznie,sąodtegoosobnegeneratory(wraziepotrzebmożemytododaćdo
edytora):
hOp://www.tablesgenerator.com/markdown_tables
14)Zdajęsobiesprawężekonwersjagotowychrozdziałówzinnychformatówmoże
byćuciążliwa.Sąnp.konwerteryzhtmlnamarkdownktóredziałająbardzodobrze.
Jedenznichdostępnyjesttu:hOps://domchrisue.github.io/to-markdown/
Jeślikorzystaszzgoogledocumentsichceszgoprzekonwertować:
1)Otwórzinteresującycięrozdział;
2)KliknijwzakładkęTools->Scripteditor;
3)Zmenuwybierzblankproject;
4)Zastąptamtenteksttym:hOps://raw.githubusercontent.com/mangini/gdocs2md/
master/converOomarkdown.gapps;
5)Zapiszprojektjakonp.MarkdownFormaOer(pamiętajabypozapisaniuprojektu
kliknąćjeszczectrl+swokienkuCode);
6)ZamknijzakładkęzeScripteditoremorazodświeżzakładkęzeswoimrozdziałem;
7)WybierzjeszczerazTools->Scripteditor;
8)KliknijwmenunaRun->MarkdownFormaOer(tupoprosicięozgodęo
autoryzację);
9)Pokilkuchwilachdostanieszemailzzałącznikiemokońcówce.md;
Jakjużrazstworzyszplugintojużdrugirazniebędzieszmusiałgodefiniować.
Poprostuwystarczyżeotworzyszrozdział->kliknieszwTools->Scripteditori
pacnieszwRun'a.
Dopoprawyjesttylkoformatowanienagłówkówiewentualniecytatów.Z
pozostałymielementamitentranslatorsobieradzi.
Wraziewątpliwościwszelkiepytaniaproszękierowaćnaemail:[email protected]