Utilia

Editor Markdownu s náhledem

Piš v Markdownu se živým, očištěným náhledem, tabulkami a úkoly GFM, počtem slov, automatickým ukládáním a exportem do .md nebo samostatného .html.

Náhled

Slova
0
Znaky
0
Doba čtení
0 min

Jak používat editor Markdownu

  1. Piš nebo vlož Markdown do pole Markdown. Náhled vedle něj (na telefonu pod ním) se aktualizuje při psaní.
  2. Tlačítka Formátování (Tučné, Kurzíva, Nadpis, Odkaz, Seznam, Citace, Kód) obalí označený text, nebo stiskni Ctrl+B / Ctrl+I (⌘B / ⌘I na Macu).
  3. Nech zaškrtnuté GitHub Flavored Markdown (tabulky, úkoly, \~\~přeškrtnutí\~\~, automatické odkazy) pro syntaxi používanou na GitHubu, nebo zaškrtnutí zruš pro prostý Markdown ve stylu CommonMark.
  4. Až skončíš, klikni na Kopírovat HTML a vlož HTML do redakčního systému nebo e-mailové šablony, na Stáhnout .md pro uložení zdroje v Markdownu, nebo na Stáhnout .html pro kompletní webovou stránku.

Počítadla pod editorem ukazují Slova a Znaky dokumentu a odhadovanou Dobu čtení při 200 slovech za minutu. Slova se počítají ve vykresleném textu, takže symboly Markdownu jako # nebo ** počet nenafouknou.

Automatické ukládání ve tvém prohlížeči

Když je zaškrtnuto Automatické ukládání v tomto prohlížeči, koncept se krátce poté, co přestaneš psát, uloží do místního úložiště tvého prohlížeče na tomto zařízení. Až se vrátíš, poslední koncept se obnoví. Nic se neodesílá na server, takže koncept tě do jiného prohlížeče ani zařízení nenásleduje. V anonymním režimu, nebo pokud je úložiště plné či zablokované, nástroj oznámí, že automatické ukládání není dostupné: stáhni si text, aby se zachoval. Zrušením zaškrtnutí se uložený koncept smaže.

Tahák k Markdownu

  • Nadpisy: # Název, ## Oddíl, ### Pododdíl
  • Zdůraznění: **tučné**, _kurzíva_, ~~přeškrtnutí~~ (GFM)
  • Odkazy: [text](https://example.com), s GFM se i holé adresy URL změní na odkazy
  • Obrázky: ![popis](data:image/png;base64,…)
  • Seznamy: - položka nebo 1. položka, úkoly pomocí - [ ] a - [x] (GFM)
  • Citace: > citovaný text
  • Kód: `v řádku` nebo blok mezi dvěma řádky se třemi zpětnými apostrofy
  • Tabulky (GFM): záhlaví, řádek | --- | --- | a pak jeden řádek na každý záznam

Bezpečnost náhledu a exportu

Markdown může obsahovat surové HTML, které by mohlo skrývat skripty. Při každém obnovení náhledu se HTML vytvořené modulem Markdownu před zobrazením vyčistí pomocí DOMPurify: odstraní se skripty, obsluhy událostí jako onclick, odkazy javascript:, vložené styly, formuláře, rámce a vložená média. Odkazy se otevírají na nové kartě. Stejné vyčištěné HTML používají Kopírovat HTML a Stáhnout .html, takže ho můžeš s klidem vkládat na jiné stránky.

Náhled zobrazuje pouze obrázky vložené jako adresy data: nebo blob:. Vzdálené obrázky, například https://…/photo.jpg, se nikdy nenačítají: bezpečnostní politika této stránky je blokuje, a díky tomu se také náhled nedá využít ke sledování tvé osoby. Nástroj ti řekne, kolik obrázků nemohl zobrazit. Markdown, který stáhneš, si ponechá původní odkazy na obrázky, takže budou fungovat všude, kde ho zveřejníš.

Soubor .html je samostatná stránka s malým zabudovaným stylem (čitelná písma, tabulky, bloky kódu a tmavý režim). Její název pochází z prvního nadpisu dokumentu, který pojmenuje i stažené soubory. Česká diakritika se ukládá v UTF-8, takže se zobrazuje správně.

Časté dotazy

Co je GitHub Flavored Markdown?

GFM je dialekt Markdownu používaný na GitHubu a mnoha dalších webech. K základní syntaxi přidává tabulky, seznamy úkolů, přeškrtnutí a automatické odkazy. Zrušením zaškrtnutí uvidíš, jak se tvůj text vykreslí bez těchto rozšíření.

Mohu v Markdownu použít HTML?

Ano, základní HTML jako <details>, <sup> nebo <kbd> funguje. Všechno nebezpečné se odstraní, stejně jako styly a značky médií.

Proč se můj obrázek nezobrazuje?

V náhledu se zobrazují jen obrázky data: a blob:, vzdálené obrázky jsou blokované. Odkaz zůstává v Markdownu a po zveřejnění funguje.

Je můj dokument soukromý?

Ano. Vykreslování, export i automatické ukládání probíhají ve tvém prohlížeči. Koncept je uložen jen v tomto zařízení a automatické ukládání můžeš kdykoli vypnout.

Jaký modul Markdownu se používá?

Nástroj používá marked, rychlý a široce používaný parser Markdownu, a DOMPurify k očištění HTML. Oba se načítají až při spuštění editoru.