Allegro Rest Api - pierwsze kroki

Allegro Rest Api - pierwsze kroki
RD
  • Rejestracja:około 12 lat
  • Ostatnio:11 miesięcy
  • Postów:212
0

Witam Was, webapi mam opanowane do perfekcji natomiast z REST nigdy nie miałem do czynienia ale po kolei. Wrzuciłem na formę 3 komponenty RestClient, RestRequest i RestResponse.
Z dokumentacji na allegro mniejwięcej tak wyglądać powinno zapytanie i to co powienienem otrzymać:

Przykładowy request do generowania kodu:

Kopiuj
curl -X POST \
  'https://allegro.pl/auth/oauth/device' \
  -H 'Authorization: Basic base64(client_id:client_secret)' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'client_id={client_id}'

**
Przykładowy response:**

Kopiuj
{
        user_code: "cbt3zdu4g",                             -- kod użytkownika - zalecamy 
                                                            przedstawić te dane użytkownikowi 
                                                            w postaci XXX XXX XXX. Taka forma 
                                                            będzie dla niego czytelniejsza 
                                                            przy przepisywaniu.
        device_code: "645629715",                           -- kod aplikacji - niezbędny 
                                                            do uzyskania tokenu dostępowego
        expires_in: "3600"                                  -- liczba sekund, przez które ważne są
                                                            oba kody
        interval: “5”,                                      -- wymagany odstęp (w sekundach) 
                                                            pomiędzy kolejnymi zapytaniami o 
                                                            status autoryzacji. Jeśli będziesz 
                                                            odpytywać częściej otrzymasz 
                                                            odpowiedź o statusie HTTP 400 z 
                                                            kodem: "slow_down".
verification_uri: “https://allegro.pl/skojarz-aplikacje”,   -- adres do weryfikacji użytkownika
verification_uri_complete: “https://allegro.pl/skojarz-aplikacje?code=645629715”   
                                                            -- adres do weryfikacji dla użytkownika z 
                                                            wypełnionym kodem użytkownika
}

Tutaj mój kod w delphi:

Kopiuj
procedure Test;
begin
  RestClient.BaseURL := 'https://allegro.pl.allegrosandbox.pl';

  RestRequest.Method := TRESTRequestMethod.rmPOST;
  RestRequest.Resource := 'auth/oauth/device';
  RestRequest.AddParameter('Authorization','Basic '+EncodeBase64(client_id+':'+client_secret),TRESTRequestParameterKind.pkHTTPHEADER);
  RestRequest.AddParameter('Content-Type','application/x-www-form-urlencoded',TRESTRequestParameterKind.pkHTTPHEADER);
  RestRequest.AddParameter('client_id',client_id,TRESTRequestParameterKind.pkGETorPOST);
  RestRequest.Execute;

  Memo1.Text := RestResponse.Content;
end;

Aplikacja zarejestrowana na allegro i taka sama nazwa aplikacji ustawiona w delphi. W odpowiedzi w memo1 otrzymuję "nie można wyświetlić strony + cała strona główna allegro w htmlu"
Gdzieś robię błąd ale brak mi już pomysłów. Odpowiedź powinna być zupełnie inna.

robertz68
  • Rejestracja:ponad 18 lat
  • Ostatnio:około 17 godzin
  • Lokalizacja:Zielona Góra
0

słyszałem że WiRL jest bardzo dobry https://github.com/delphi-blocks/WiRL

RD
  • Rejestracja:około 12 lat
  • Ostatnio:11 miesięcy
  • Postów:212
0

Ale komponenty raczej nie są problemem gdyż jak zmienię jedną literę w

Kopiuj
RestRequest.Resource := 'auth/oauth/device';

to otrzymuję w memo1 prawidłowy komunikat: **{"error":"unauthorized","error_description":"Full authentication is required to access this resource"} **

edytowany 1x, ostatnio: Rafał D
robertz68
  • Rejestracja:ponad 18 lat
  • Ostatnio:około 17 godzin
  • Lokalizacja:Zielona Góra
0

autoryzację masz robioną używając Base64, upewnij się że twoja funkcja base64 działa prawidłowo. Najlepiej zakoduj kawałek stringa tą funkcją i porównaj czy w wersji php (na jakiejś stronie) czy otrzymujesz ten sam wynik. Kiedyś miałem właśnie problem w podobnej sytuacji. Dodatkowo pisz kod używając UTF8 na wszelki wypadek.

RD
  • Rejestracja:około 12 lat
  • Ostatnio:11 miesięcy
  • Postów:212
0

To była pierwsza czynność jaką sprawdziłem :) Używam tej funckji z modułu: Synacode

Kopiuj
curl -X POST \
  'https://allegro.pl/auth/oauth/device' \
  -H 'Authorization: Basic base64(client_id:client_secret)' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'client_id={client_id}'

Przyznam szczerze że za bardzo nie wiem co oznacza w powyższym zapisie -H oraz -d

edytowany 2x, ostatnio: flowCRANE
KA
  • Rejestracja:prawie 20 lat
  • Ostatnio:około 15 godzin
  • Lokalizacja:Gorlice
0

-H to Header czyli nagłówek
i tu popełniasz bład
-d to Data czyli dane (parametry) które wysyłasz metodą POST


Nie odpowiadam na PW w sprawie pomocy programistycznej.
Pytania zadawaj na forum, bo:
od tego ono jest ;) | celowo nie zawracasz gitary | przeczyta to więcej osób a więc większe szanse że ktoś pomoże.
edytowany 1x, ostatnio: kAzek
robertz68
  • Rejestracja:ponad 18 lat
  • Ostatnio:około 17 godzin
  • Lokalizacja:Zielona Góra
0
RD
  • Rejestracja:około 12 lat
  • Ostatnio:11 miesięcy
  • Postów:212
0

Napisałem taką procedurę w oparciu o Indy

Kopiuj
procedure TForm2.Button1Click(Sender: TObject);
var
  Indy : TIdHTTP;
  IdSSL : TIdSSLIOHandlerSocketOpenSSL;
  Data : String;
  JSONToSend : TStringStream;
  Response: string;
begin
  Indy := TIdHTTP.Create(nil);
  try
    IdSSL := TIdSSLIOHandlerSocketOpenSSL.Create(Indy);
    IdSSL.SSLOptions.SSLVersions := [sslvTLSv1_2];
    Indy.IOHandler := IdSSL;
    Indy.Request.BasicAuthentication := False;
    Indy.Request.CustomHeaders.Values['Authorization'] := 'Basic '+EncodeBase64(client_id+':'+client_secret);
    Indy.Request.ContentType := 'application/x-www-form-urlencoded';
    Data := 'client_id='+client_id;
    JSONToSend := TStringStream.Create(Data,TEncoding.UTF8);
    try  
      Response := Indy.Post('https://allegro.pl.allegrosandbox.pl/auth/oauth/device',JSONToSend);
    finally
     JSONToSend.Free;
    end;    
     memo1.Text := Response;
  finally
    Indy.Free;
  end;
end;

I działa poprawnie zwraca to co potrzeba. Jednak jako że jestem uparty nadal nie potrafię sobie poradzić z kontrolkami Restclinet, restresponse. Teoretycznie nagłówek czyli header to jest to:

Kopiuj

RestRequest.AddParameter('Authorization','Basic '+EncodeBase64(client_id+':'+client_secret),TRESTRequestParameterKind.pkHTTPHEADER);
RestRequest.AddParameter('Content-Type','application/x-www-form-urlencoded',TRESTRequestParameterKind.pkHTTPHEADER); 

natomiast dana to niby to

Kopiuj
RestRequest.AddParameter('client_id',client_id,TRESTRequestParameterKind.pkGETorPOST);

Nawet próbuję wykorzystać Rest debugger od embarcadero i tam też nie mogę sobie poradzić. Gdzie się wprowadza nagłówki a gdzie dane?

edytowany 1x, ostatnio: Rafał D
RD
  • Rejestracja:około 12 lat
  • Ostatnio:11 miesięcy
  • Postów:212
0

Już sobie poradziłem z RestClient, RestResponse, RestRequest. popełniałem banalny błąd aż wstyd się przyznać. Jednakże zostanę chyba przy rozwiązaniu z Indy gdyż program będzie lżejszy.

WN
Napisz, proszę jaki to błąd, bo ja mam cały czas błąd 401 w przypadku Indy, a w przypadku RestClient - error connecting with SSL 1409442E
WN
  • Rejestracja:około 6 lat
  • Ostatnio:około rok
  • Postów:8
0

Napisz, proszę, jaki to błąd, bo korzystając z Indy mam w odpowiedzi 401, a w przypadku RestClient - error connecting with SSL.

KA
  • Rejestracja:prawie 20 lat
  • Ostatnio:około 15 godzin
  • Lokalizacja:Gorlice
1

Co do błędów połączeń SSL zawsze sprawdzajcie aktualność bibliotek OpenSSL, bo w przypadku nieaktualnych serwery mogą po prostu odrzucać połączenie.


Nie odpowiadam na PW w sprawie pomocy programistycznej.
Pytania zadawaj na forum, bo:
od tego ono jest ;) | celowo nie zawracasz gitary | przeczyta to więcej osób a więc większe szanse że ktoś pomoże.
WN
  • Rejestracja:około 6 lat
  • Ostatnio:około rok
  • Postów:8
0

Zainstalowałem libeay32 i ssleay32.dll z 22-11-2018. Są jeszcze nowsze?

KA
  • Rejestracja:prawie 20 lat
  • Ostatnio:około 15 godzin
  • Lokalizacja:Gorlice
1

Tak, najnowszą wersją jest 1.0.2r. a na przyszłość to od tego jest numer wersji aby po tym rozpoznawać a nie szukać po dacie.
https://indy.fulgan.com/SSL/


Nie odpowiadam na PW w sprawie pomocy programistycznej.
Pytania zadawaj na forum, bo:
od tego ono jest ;) | celowo nie zawracasz gitary | przeczyta to więcej osób a więc większe szanse że ktoś pomoże.
edytowany 1x, ostatnio: kAzek
WN
  • Rejestracja:około 6 lat
  • Ostatnio:około rok
  • Postów:8
0

Zainstalowałem tę, o której piszesz (openssl-1.0 .2r-i386-win32), jeszcze ciepła, z dzisiejszego ranka, ale dalej to samo. Próbowałem zarówno z typem aplikacji Web, jak i Device. Mam się wcześniej zalogować na stronie allegro lub allegrosandbox?

KA
  • Rejestracja:prawie 20 lat
  • Ostatnio:około 15 godzin
  • Lokalizacja:Gorlice
0

Nie widziałem Twojego kodu nawet w sumie nie bardzo rozumiem czy robisz na RestClient czy Indy ale zwróć uwagę na nagłówki. Jak chcesz pomocy to pokaż kod (to swoje ID sobie z x-ksuj) inaczej nikt nie wie w czym może być problem.


Nie odpowiadam na PW w sprawie pomocy programistycznej.
Pytania zadawaj na forum, bo:
od tego ono jest ;) | celowo nie zawracasz gitary | przeczyta to więcej osób a więc większe szanse że ktoś pomoże.
WN
  • Rejestracja:około 6 lat
  • Ostatnio:około rok
  • Postów:8
0

Załączam kod i odpowiedź zarejestrowaną przez idLogDebug

Kopiuj
var
  Indy        : TIdHTTP;
  IdSSL       : TIdSSLIOHandlerSocketOpenSSL;
  JSONToSend  : TStringStream;
  postStrings : tstringlist;
  Response,
  l_data      : string;

begin
  Indy := TIdHTTP.Create(nil);
  try
    IdSSL := TIdSSLIOHandlerSocketOpenSSL.Create(Indy);
    IdSSL.SSLOptions.SSLVersions := [sslvTLSv1_2]; //
    IdSSL.SSLOptions.Method      :=  sslvTLSv1_2;
    IdSSL.SSLOptions.Mode        :=  sslmUnassigned;
    Indy.HTTPOptions  := [hoForceEncodeParams];
    Indy.IOHandler    := IdSSL;
    idSSL.Intercept   := idLogDebug; 
    idLogDebug.Active := true;
    Indy.Request.BasicAuthentication := false;
    Indy.Request.CustomHeaders.Values['Authorization'] := 'Basic '+ EncodeBase64(client_id + ':' + client_secret);
    Indy.Request.ContentType := 'application/x-www-form-urlencoded';
    Indy.Request.AcceptLanguage := 'pl-PL';
    Indy.Request.UserAgent := 'User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Iron/35.0.1900.0 Chrome/35.0.1900.0 Safari/537.36';

    postStrings := TStringList.Create;
    postStrings.Encoding.UTF8;
    postStrings.Add('client_id=' + client_id);
    L_data := 'client_id=' + client_id;
    JSONToSend := TStringStream.Create(L_data,TEncoding.UTF8);

    try
      Response := Indy.Post('https://allegro.pl.allegrosandbox.pl/auth/oauth/device',JSONToSend);
      MemoContent.Text := Response;
      JSONToSend.Free;
    except
      on E: EIdHTTPProtocolException do
        ShowMessage('HTTP request failed'#13 + IntToStr(E.ErrorCode) + ' ' + E.Message);
      on E: EIdOpenSSLAPISSLError do
        ShowMessage('OpenSSL API failure'#13 + E.ClassName + #13'Result Code: ' + IntToStr(E.RetCode) + #13'Error Code: ' + IntToStr(E.ErrorCode));
      on E: EIdOpenSSLAPICryptoError do
        ShowMessage('OpenSSL crypto failure'#13 + E.ClassName + #13'Error Code: ' + IntToStr(E.ErrorCode));
      on E: EIdOpenSSLError do
        ShowMessage('Unknown OpenSSL error'#13 + E.ClassName + #13 + E.Message);
      on E: EIdSocketError do
        ShowMessage('Socket error'#13 + E.ClassName + #13'Error Code: ' + IntToStr(E.LastError) + ' ' + E.Message);
      on E: Exception do
        ShowMessage('Unexpected error'#13 + E.ClassName + #13 + E.Message);
    end;
  finally
    Indy.Free;
    JSONToSend.Free;
  end;
end;

Poniżej to co zarejestrował idLogDebug. To co niekoniecznie powinny oglądać osoby postronne jest w postaci {OPIS_POLA}

Kopiuj
Debug Output:
Sent 2019-03-16 21:53:23: POST /auth/oauth/device HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 42
Authorization: Basic {KOD_AUTORYZACJI}
Host: allegro.pl.allegrosandbox.pl
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Encoding: identity
Accept-Language: pl-PL
User-Agent: User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Iron/35.0.1900.0 Chrome/35.0.1900.0 Safari/537.36

Process Allegro.exe (11492)
Debug Output: Sent 2019-03-16 21:53:23: client_id={CLIENT_ID} Process Allegro.exe (11492)
Debug Output:
Recv 2019-03-16 21:53:24: HTTP/1.1 401 Unauthorized
Date: Sat, 16 Mar 2019 20:53:25 GMT
Content-Type: text/html;charset=UTF-8
Connection: close
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
WWW-Authenticate: Basic realm="Allegro"
Content-Language: pl-PL
X-Backend: auth_{KOD_AUTH}
Vary: Accept-Encoding
Age: 0
X-Req-Counter: 1
Content-Security-Policy: block-all-mixed-content; report-uri https://allegroapi.io/seclog/csp;
X-Hit: HIT 0
X-Origin: plu-varnish-esi01
X-Content-Type-Options: nosniff
grace: none
X-XSS-Protection: 1; report=https://allegro.pl.allegrosandbox.pl/seclog/xss
X-Via-LB: hap-rnd-1b.dc4.local
X-Frame-Options: SAMEORIGIN
Strict-Transport-Security: max-age=15552000
Set-Cookie: _cmuid={KOD_COOKIE}; Expires=Mon, 15 Mar 2021 20:53:26 GMT; Path=/; Domain=.allegro.pl.allegrosandbox.pl; Secure
edytowany 1x, ostatnio: flowCRANE
WN
  • Rejestracja:około 6 lat
  • Ostatnio:około rok
  • Postów:8
0

Te zmienna postStrings mozna pominac, kombinowalem jeszcze z innym typem.

WN
  • Rejestracja:około 6 lat
  • Ostatnio:około rok
  • Postów:8
0

Strasznie ten kod sformatowany po wysłaniu, spróbuje jeszcze raz

Kopiuj
procedure TForm1.Button3Click(Sender: TObject);

var   Indy        : TIdHTTP;
        IdSSL       : TIdSSLIOHandlerSocketOpenSSL;
        JSONToSend  : TStringStream;
        postStrings : tstringlist;
       Response,
       l_data      : string;

begin
  Indy := TIdHTTP.Create(nil);
  try
    IdSSL := TIdSSLIOHandlerSocketOpenSSL.Create(Indy);
    IdSSL.SSLOptions.SSLVersions := [sslvTLSv1_2]; //
    IdSSL.SSLOptions.Method      :=  sslvTLSv1_2;
    IdSSL.SSLOptions.Mode        :=  sslmUnassigned;
    Indy.HTTPOptions  := [hoForceEncodeParams];
    Indy.IOHandler    := IdSSL;
    idSSL.Intercept   := idLogDebug; 
    idLogDebug.Active := true;
    Indy.Request.BasicAuthentication := false;
    Indy.Request.CustomHeaders.Values['Authorization'] := 'Basic '+ EncodeBase64(client_id + ':' + client_secret);
    Indy.Request.ContentType := 'application/x-www-form-urlencoded';
    Indy.Request.AcceptLanguage := 'pl-PL';
    Indy.Request.UserAgent := 'User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Iron/35.0.1900.0 Chrome/35.0.1900.0 Safari/537.36';
   
    L_data := 'client_id=' + client_id;
    JSONToSend := TStringStream.Create(L_data,TEncoding.UTF8);

    try
      Response := Indy.Post('https://allegro.pl.allegrosandbox.pl/auth/oauth/device',JSONToSend);
      MemoContent.Text := Response;
      JSONToSend.Free;
    except
      on E: EIdHTTPProtocolException do
        ShowMessage('HTTP request failed'#13 + IntToStr(E.ErrorCode) + ' ' + E.Message);
      on E: EIdOpenSSLAPISSLError do
        ShowMessage('OpenSSL API failure'#13 + E.ClassName + #13'Result Code: ' + IntToStr(E.RetCode) + #13'Error Code: ' + IntToStr(E.ErrorCode));
      on E: EIdOpenSSLAPICryptoError do
        ShowMessage('OpenSSL crypto failure'#13 + E.ClassName + #13'Error Code: ' + IntToStr(E.ErrorCode));
      on E: EIdOpenSSLError do
        ShowMessage('Unknown OpenSSL error'#13 + E.ClassName + #13 + E.Message);
      on E: EIdSocketError do
        ShowMessage('Socket error'#13 + E.ClassName + #13'Error Code: ' + IntToStr(E.LastError) + ' ' + E.Message);
      on E: Exception do
        ShowMessage('Unexpected error'#13 + E.ClassName + #13 + E.Message);
    end;
  finally
    Indy.Free;
    JSONToSend.Free;
  end;
end;
edytowany 1x, ostatnio: flowCRANE
CL
Jak edytujesz post to po prawej masz okno "Jak formatować treść postu" a na lewo od okna ikonę ze znakiem zapytania - pomoc. Poczytaj odnośnie tego formatowania. Kod wstaw w znacznik [3x apostrof + 'delphi']
KA
  • Rejestracja:prawie 20 lat
  • Ostatnio:około 15 godzin
  • Lokalizacja:Gorlice
1

Ten kod działa (mimo że brzydki). Pytanie czy na pewno zarejestrowałeś swoją apkę na sandboxa a nie przypadkiem na normalnym allegro, skoro testujesz w środowisku sandbox? Bo tego co widzę w dokumentacji są osobne strony rejestracji. Zresztą zobacz tabelkę w części "Środowisko testowe" prawie na samym dole strony. https://developer.allegro.pl/about/#auth


Nie odpowiadam na PW w sprawie pomocy programistycznej.
Pytania zadawaj na forum, bo:
od tego ono jest ;) | celowo nie zawracasz gitary | przeczyta to więcej osób a więc większe szanse że ktoś pomoże.
edytowany 1x, ostatnio: kAzek
WN
  • Rejestracja:około 6 lat
  • Ostatnio:około rok
  • Postów:8
0

Dzięki piękne, przy wejściu na stronę Sandbox i wybraniu Allegro API przekierowuje na stronę normalnego Allegro i tam się rejestruje apka.

MK
  • Rejestracja:około 17 lat
  • Ostatnio:ponad 2 lata
0

Czy ktoś z Was może gdzieś jakiś tutorial widział i by wrzucił na forum co do REST API dla allegro, że by jakoś łatwiej było dla początkujących. Może macie jakieś źródła demo?

Kliknij, aby dodać treść...

Pomoc 1.18.8

Typografia

Edytor obsługuje składnie Markdown, w której pojedynczy akcent *kursywa* oraz _kursywa_ to pochylenie. Z kolei podwójny akcent **pogrubienie** oraz __pogrubienie__ to pogrubienie. Dodanie znaczników ~~strike~~ to przekreślenie.

Możesz dodać formatowanie komendami , , oraz .

Ponieważ dekoracja podkreślenia jest przeznaczona na linki, markdown nie zawiera specjalnej składni dla podkreślenia. Dlatego by dodać podkreślenie, użyj <u>underline</u>.

Komendy formatujące reagują na skróty klawiszowe: Ctrl+B, Ctrl+I, Ctrl+U oraz Ctrl+S.

Linki

By dodać link w edytorze użyj komendy lub użyj składni [title](link). URL umieszczony w linku lub nawet URL umieszczony bezpośrednio w tekście będzie aktywny i klikalny.

Jeżeli chcesz, możesz samodzielnie dodać link: <a href="link">title</a>.

Wewnętrzne odnośniki

Możesz umieścić odnośnik do wewnętrznej podstrony, używając następującej składni: [[Delphi/Kompendium]] lub [[Delphi/Kompendium|kliknij, aby przejść do kompendium]]. Odnośniki mogą prowadzić do Forum 4programmers.net lub np. do Kompendium.

Wspomnienia użytkowników

By wspomnieć użytkownika forum, wpisz w formularzu znak @. Zobaczysz okienko samouzupełniające nazwy użytkowników. Samouzupełnienie dobierze odpowiedni format wspomnienia, zależnie od tego czy w nazwie użytkownika znajduje się spacja.

Znaczniki HTML

Dozwolone jest używanie niektórych znaczników HTML: <a>, <b>, <i>, <kbd>, <del>, <strong>, <dfn>, <pre>, <blockquote>, <hr/>, <sub>, <sup> oraz <img/>.

Skróty klawiszowe

Dodaj kombinację klawiszy komendą notacji klawiszy lub skrótem klawiszowym Alt+K.

Reprezentuj kombinacje klawiszowe używając taga <kbd>. Oddziel od siebie klawisze znakiem plus, np <kbd>Alt+Tab</kbd>.

Indeks górny oraz dolny

Przykład: wpisując H<sub>2</sub>O i m<sup>2</sup> otrzymasz: H2O i m2.

Składnia Tex

By precyzyjnie wyrazić działanie matematyczne, użyj składni Tex.

<tex>arcctg(x) = argtan(\frac{1}{x}) = arcsin(\frac{1}{\sqrt{1+x^2}})</tex>

Kod źródłowy

Krótkie fragmenty kodu

Wszelkie jednolinijkowe instrukcje języka programowania powinny być zawarte pomiędzy obróconymi apostrofami: `kod instrukcji` lub ``console.log(`string`);``.

Kod wielolinijkowy

Dodaj fragment kodu komendą . Fragmenty kodu zajmujące całą lub więcej linijek powinny być umieszczone w wielolinijkowym fragmencie kodu. Znaczniki ``` lub ~~~ umożliwiają kolorowanie różnych języków programowania. Możemy nadać nazwę języka programowania używając auto-uzupełnienia, kod został pokolorowany używając konkretnych ustawień kolorowania składni:

```javascript
document.write('Hello World');
```

Możesz zaznaczyć również już wklejony kod w edytorze, i użyć komendy  by zamienić go w kod. Użyj kombinacji Ctrl+`, by dodać fragment kodu bez oznaczników języka.

Tabelki

Dodaj przykładową tabelkę używając komendy . Przykładowa tabelka składa się z dwóch kolumn, nagłówka i jednego wiersza.

Wygeneruj tabelkę na podstawie szablonu. Oddziel komórki separatorem ; lub |, a następnie zaznacz szablonu.

nazwisko;dziedzina;odkrycie
Pitagoras;mathematics;Pythagorean Theorem
Albert Einstein;physics;General Relativity
Marie Curie, Pierre Curie;chemistry;Radium, Polonium

Użyj komendy by zamienić zaznaczony szablon na tabelkę Markdown.

Lista uporządkowana i nieuporządkowana

Możliwe jest tworzenie listy numerowanych oraz wypunktowanych. Wystarczy, że pierwszym znakiem linii będzie * lub - dla listy nieuporządkowanej oraz 1. dla listy uporządkowanej.

Użyj komendy by dodać listę uporządkowaną.

1. Lista numerowana
2. Lista numerowana

Użyj komendy by dodać listę nieuporządkowaną.

* Lista wypunktowana
* Lista wypunktowana
** Lista wypunktowana (drugi poziom)

Składnia Markdown

Edytor obsługuje składnię Markdown, która składa się ze znaków specjalnych. Dostępne komendy, jak formatowanie , dodanie tabelki lub fragmentu kodu są w pewnym sensie świadome otaczającej jej składni, i postarają się unikać uszkodzenia jej.

Dla przykładu, używając tylko dostępnych komend, nie możemy dodać formatowania pogrubienia do kodu wielolinijkowego, albo dodać listy do tabelki - mogłoby to doprowadzić do uszkodzenia składni.

W pewnych odosobnionych przypadkach brak nowej linii przed elementami markdown również mógłby uszkodzić składnie, dlatego edytor dodaje brakujące nowe linie. Dla przykładu, dodanie formatowania pochylenia zaraz po tabelce, mogłoby zostać błędne zinterpretowane, więc edytor doda oddzielającą nową linię pomiędzy tabelką, a pochyleniem.

Skróty klawiszowe

Skróty formatujące, kiedy w edytorze znajduje się pojedynczy kursor, wstawiają sformatowany tekst przykładowy. Jeśli w edytorze znajduje się zaznaczenie (słowo, linijka, paragraf), wtedy zaznaczenie zostaje sformatowane.

  • Ctrl+B - dodaj pogrubienie lub pogrub zaznaczenie
  • Ctrl+I - dodaj pochylenie lub pochyl zaznaczenie
  • Ctrl+U - dodaj podkreślenie lub podkreśl zaznaczenie
  • Ctrl+S - dodaj przekreślenie lub przekreśl zaznaczenie

Notacja Klawiszy

  • Alt+K - dodaj notację klawiszy

Fragment kodu bez oznacznika

  • Alt+C - dodaj pusty fragment kodu

Skróty operujące na kodzie i linijkach:

  • Alt+L - zaznaczenie całej linii
  • Alt+, Alt+ - przeniesienie linijki w której znajduje się kursor w górę/dół.
  • Tab/⌘+] - dodaj wcięcie (wcięcie w prawo)
  • Shit+Tab/⌘+[ - usunięcie wcięcia (wycięcie w lewo)

Dodawanie postów:

  • Ctrl+Enter - dodaj post
  • ⌘+Enter - dodaj post (MacOS)