rubrici

pentru a crea un titlu, adăugați unul la șase simboluri # înainte de titlul textului. Numărul de # pe care îl utilizați va determina dimensiunea titlului.

# The largest heading## The second largest heading###### The smallest heading

Styling text

puteți indica accentul pus cu bold, italic, sau text tăiat.

citând textul

puteți cita textul cu un >.,

In the words of Abraham Lincoln:> Pardon my French

Indicație: Când vizualizați o conversație, puteți în mod automat text citat într-un comentariu de evidențiere text, apoi tastați r. Puteți cita un întreg comentariu făcând clic, apoi Citat răspuns. Pentru mai multe informații despre scurtăturile de la tastatură, consultați „scurtături de la tastatură.”

citând codul

puteți apela cod sau o comandă într-o propoziție cu backstick-uri unice. Textul din backsticks nu va fi formatat.,

Use `git status` to list all new or modified files that haven't yet been committed.

Pentru formatul de cod sau de text în propriile sale distincte bloc, triplu backticks.

Some basic Git commands are:```git statusgit addgit commit```

Pentru mai multe informații, consultați „Crearea și evidențierea blocuri de cod.”

Legaturi

puteți crea o linie link-ul de ambalaj link-ul de text, în paranteze , și apoi ambalaj URL-ul în paranteze ( ). De asemenea, puteți utiliza comanda rapidă de la tastatură command + k pentru a crea un link.,

This site was built using (https://pages.github.com/).

Sfat: GitHub creează în mod automat link-uri atunci când Url-uri valide sunt scrise într-un comentariu. Pentru mai multe informații, consultați „Referințe și adrese URL Autolinkate.”

Secțiunea link-uri

puteți lega direct la o secțiune într-un prestate de fișiere de deasupra secțiunii de a expune link-ul:

link-uri Relative

puteți defini legături relative și căi de imagine în redate fișiere pentru a ajuta cititorii să navigați la alte fișiere în depozit.,

un link relativ este un link care este relativ la fișierul curent. De exemplu, dacă aveți un fișier README în rădăcină de depozit, și aveți un alt fișier în docs/CONTRIBUIE.md, relativă link-ul de la care CONTRIBUIE.md în README ar putea arata astfel:

(docs/CONTRIBUTING.md)

GitHub va transforma automat relativă link-ul sau calea de imagine bazat pe orice ramură sunteți în prezent pe, astfel încât link-ul sau calea funcționează întotdeauna. Puteți utiliza toți operanzii de legături relative, cum ar fi ./ și ../.,

legăturile Relative sunt mai ușoare pentru utilizatorii care vă clonează depozitul. Este posibil ca legăturile Absolute să nu funcționeze în clonele depozitului dvs. – vă recomandăm să utilizați legături relative pentru a vă referi la alte fișiere din depozitul dvs.

Liste

puteți face o lista neordonata de precedent una sau mai multe linii de text cu - sau *.

- George Washington- John Adams- Thomas Jefferson

Pentru a comanda lista ta, preced fiecare linie cu un număr.,

1. James Madison2. James Monroe3. John Quincy Adams

Liste Imbricate

puteți crea o listă imbricată prin crestarea unul sau mai multe elemente de listă mai jos un alt element.

pentru a crea o listă imbricată folosind Editorul web de pe GitHub sau un editor de text care utilizează un font monospațiat, cum ar fi Atom, vă puteți alinia lista vizual. Tipul de caractere spațiu în fața ta imbricate element din listă, până când lista marker caracter (- sau *) se află direct sub primul caracter al textului în elementul de mai sus.,

1. First list item - First nested list item - Second nested list item

Pentru a crea o listă imbricată în editor comentariu pe GitHub, care nu utilizează un font monospaced, poti sa te uiti la articol de pe listă, imediat deasupra listă imbricată și conta numărul de caractere care apar înainte de conținutul elementului. Apoi tastați acel număr de caractere spațiale în fața elementului de listă imbricat.,

În acest exemplu, ați putea adăuga un imbricate lista element din lista element 100. First list item prin crestarea imbricate element din listă un minim de cinci spații, deoarece există cinci personaje () înainte First list item.

100. First list item - First nested list item

puteți crea mai multe niveluri de liste imbricate, folosind aceeași metodă., De exemplu, pentru prima imbricate element din listă are șapte spații (␣␣␣␣␣-␣) inainte de a imbricate lista de conținut First nested list item, va trebui să liniuța a doua imbricate element din listă de șapte spații.

100. First list item - First nested list item - Second nested list item

Pentru mai multe exemple, consultați Spec.

liste de activități

pentru a crea o listă de activități, prefațați elementele din listă cu un caracter spațiu obișnuit urmat de . Pentru a marca o sarcină ca fiind completă, utilizați .,

- Finish my changes- Push my commits to GitHub- Open a pull request

Dacă o listă de activități element descriere începe cu o paranteză, va trebui să scape de ea cu \:

- \(Optional) Open a followup issue

Pentru mai multe informații, a se vedea „Despre liste de sarcini.”

menționarea persoanelor și echipelor

puteți menționa o persoană sau o echipă pe GitHub tastând @ plus numele de utilizator sau numele echipei. Acest lucru va declanșa o notificare și le va atrage atenția asupra conversației., Oamenii vor primi, de asemenea, o notificare dacă editați un comentariu pentru a menționa numele lor de utilizator sau numele echipei. Pentru mai multe informații despre notificări, consultați „Despre notificări.”

@github/support What do you think about these updates?

atunci Când vorbim de o echipa de bază, membrii consiliului său de copil echipe primi, de asemenea notificări, simplificând comunicarea cu mai multe grupuri de oameni. Pentru mai multe informații, consultați „Despre Echipe.”

tastând un simbol@ va afișa o listă de persoane sau Echipe dintr-un proiect., Lista filtrează pe măsură ce tastați, așa că, odată ce găsiți numele persoanei sau echipei pe care o căutați, puteți utiliza tastele săgeată pentru a o selecta și apăsați fie tab, fie enter pentru a completa numele. Pentru echipe, introduceți @organization / team-name și toți membrii acelei echipe se vor abona la conversație.

rezultatele de completare automată sunt limitate la colaboratori depozit și orice alți participanți pe firul.

probleme de referință și solicitări pull

puteți afișa o listă de probleme sugerate și solicitări pull în depozit tastând #., Tastați problema sau trageți numărul sau titlul solicitării pentru a filtra lista, apoi apăsați fie tab, fie enter pentru a finaliza rezultatul evidențiat.

Pentru mai multe informații, consultați „Referințe și adrese URL Autolinkate.”

referirea la resurse externe

dacă referințele personalizate autolink sunt configurate pentru un depozit, atunci referințele la resurse externe, cum ar fi o problemă JIRA sau un bilet Zendesk, se convertesc în legături scurtate. Pentru a ști ce AUTOLINK-uri sunt disponibile în depozitul dvs., contactați pe cineva cu permisiuni de administrator la depozit., Pentru mai multe informații, consultați „Configurarea legăturilor automate pentru a face referință la resurse externe.”

atașamente de conținut

unele aplicații GitHub oferă informații în GitHub pentru adresele URL care se leagă de domeniile lor înregistrate. GitHub redă informațiile furnizate de aplicație sub adresa URL din corp sau comentariul unei probleme sau solicitări de tragere.

pentru a vedea atașamentele de conținut, trebuie să aveți o aplicație GitHub care utilizează API-ul atașamentelor de conținut instalat în depozit., Pentru mai multe informații, consultați „Instalarea unei aplicații în contul personal” și „instalarea unei aplicații în organizația dvs.”

fișierele atașate la conținut nu vor fi afișate pentru adresele URL care fac parte dintr-un link de marcare.

Pentru mai multe informații despre construirea unei aplicații GitHub care utilizează fișiere atașate de conținut, consultați „Utilizarea fișierelor atașate de conținut.”

folosind emoji

puteți adăuga emoji la scrierea dvs. tastând :EMOJICODE:.

@octocat :+1: This PR looks great - it's ready to merge! :shipit:

Tastarea : va aduce o listă de sugestii de emoji., Lista se va filtra pe măsură ce tastați, așa că, odată ce găsiți emoji-ul pe care îl căutați, apăsați Tab sau Enter pentru a finaliza rezultatul evidențiat.pentru o listă completă de emoji și coduri disponibile, consultați foaia Emoji-Cheat.

paragrafe

puteți crea un nou paragraf lăsând o linie goală între liniile de text.

ignorarea formatării Markdown

puteți spune GitHub să ignore (sau să scape) formatarea Markdown folosind \ înainte de caracterul Markdown.,

Let's rename \*our-new-project\* to \*our-old-project\*.

Pentru mai multe informații, consultați Daring Fireball e „Sintaxa Markdown.”

Lectură suplimentară

  • Github flavoured Markdown Spec
  • „despre scrierea și formatarea pe GitHub”
  • „lucrul cu formatarea avansată”
  • „Mastering Markdown”