Задаване на предпоставките:
За да видим как работи влагането на списъка, имаме нужда от инструмент или софтуер, където можем да внедрим скрипта за маркиране. Открихме, че Visual Studio Code е най-добрият асемблер за скриптовете за маркдаун. За да приложим езика за маркиране, трябва да направим някои промени според изискванията на нашата задача. Стартирахме VS Code и създадохме нов проектен файл. По подразбиране той отваря обикновен текстов файл, но трябва да работим върху маркирането, така че ще променим типа на файла. Опцията „Обикновен текст“ може да се намери в десния ъгъл на лентата на състоянието и се използва за промяна на типа на файла. Когато поставите курсора върху него, той иска да изберете езиков режим.
Когато го натиснете, ще се появи меню. Просто трябва да напишете „Markdown“, за да изберете езика на markdown.
Това ще промени нашия файлов тип от „Plain Text“ на „Markdown“.
Можете да видите в предходната моментна снимка, че типът файл вече е „Markdown“.
След това трябва да добавим разширение, за да може скриптовете за маркдаун да бъдат визуализирани и да работят правилно. За да добавите това разширение от лявата лента с инструменти, опцията за настройки ще ви предостави поле за избор, където сме избрали опцията „Разширение“.
Това ще отвори прозорец. Трябва да напишем името на разширението като „Markdown All in One“ и да го инсталираме.
Сега разширението за маркиране е успешно добавено към нашия файл.
Последното нещо, което трябва да направим, е да отворим прозорец за визуализация, за да видим резултата от нашите генерирани скриптове. Прозорецът за предварителен преглед може да бъде стартиран чрез щракване върху клавишите „Ctrl+Shift+V“ или можете да щракнете върху иконата с клавиш в горния десен ъгъл на инструмента.
Щракването върху него ще раздели прозореца на два екрана. Първият ще се използва за въвеждане на скриптовете, докато резултатът от скрипта ще се покаже в прозореца „Преглед“.
Вече можем да използваме този инструмент, за да започнем работа по скриптовете за маркиране. Нека сега да проучим скриптовете.
Избягване на обратни тикчета в Markdown:
В Markdown обратните точки се използват за създаване на кодови блокове. Когато вмъкваме обратна отметка, това се отнася за стартиране на кодов фрагмент в Markdown. Добавя се една обратна отметка в началото и в края на всеки ред код, за да се създадат вградени кодови блокове в документите. Поради тези обратни точки става трудно да се покажат обратните точки като текст в документ, без да се активира генерирането на кодови блокове. В този урок ще работим върху това как можем да избегнем обратна отметка, така че да можем да го включим като текст, вместо да го третираме като начало на синтаксиса на кода.
Най-лесният начин за пропускане на обратна отметка е да добавите обратна наклонена черта (\), преди да вмъкнете обратната отметка. Ако не добавите обратна наклонена черта, обратната отметка, която бихте добавили като текст, и следващата обратна отметка в кода ще бъдат вмъкнати. Какъвто и текст да сте добавили между тях, ще се счита за кодов блок, така че за да избегнете това, поставете обратна наклонена черта. Първо ще добавим обратните отметки, за да генерираме кодов блок, и след това ще се научим да избягваме обратната отметка в markdown в тази демонстрация.
Първо създадохме заглавка за нашия документ. За да генерираме заглавката на първо ниво, трябва да вмъкнем единичен хеш символ (#), да добавим интервал и след това да споменем текста за заглавката. Предоставихме текста като „Markdown Backtick“. Сега, за да създадем кодов блок, първо добавихме обратна отметка (`) и поставихме интервал след нея. След това написахме текста като „Примерен текст“, последван от интервал, където се прилага затварящата обратна отметка. Сега тези две обратни отметки ще считат текста между тях за кодов фрагмент и по този начин ще го изобразят като кодов блок.
Това ни дава заглавка „Markdown Backtick“ и текста, който споменахме по-горе, във формата на кодовия блок. Можете да видите очаквания резултат в моментната снимка на прозореца за визуализация, която предоставихме по-долу:
Сега, за да избегнем тази обратна отметка и да изобразим текста като обикновен текст, а не като кодов блок, трябва да използваме обратната наклонена черта (\) преди началната обратна отметка, а също и преди затварящата обратна отметка. И така, бихме направили този трик върху горния кодов блок, за да го изобразим като обикновен текст, като добавим обратни наклонени черти.
Създадохме заглавка с текст „Markdown Escaping a Backtick“. След като пропуснахме ред, добавихме обратна наклонена черта, последвана от обратна отметка. Предоставя се място и след това текстът се посочва като „Примерен текст“. Преди да добавим затварящата обратна отметка, сме вмъкнали друга обратна наклонена черта.
Прозорецът за предварителен преглед показва очаквания резултат, където текстовият низ е изложен като обикновен текст с обратни отметки. И така, добавихме обратната отметка, без да задействаме нейната функционалност за обръщане на текста към кодовия блок.
В горния пример текстът е обвит между две обратни отметки. Ако искаме да добавим една обратна отметка в кодовия блок, без да го считаме за синтаксис за генериране на кодовия блок. За целта добавихме две обратни отметки, интервал и след това текста като „Добавяме обратна отметка: ` “. Можете да видите, че тук искаме да покажем обратната отметка, без да я използваме като част от синтаксиса. След това дадохме място и добавихме две затварящи обратни точки.
Очакваният резултат се показва. Това има кодов блок, който има обратна отметка като част от него.
Сега ще създадем друг пример за разбиране на концепцията. Тук ще създадем математически израз и ще го запишем като кодов блок в маркдаун в съответствие с обикновен текст. Записали сме го като „Ако `y = 9` , това означава, че `y -3 = 6` “. Тук сме използвали обратни точки на „y = 9“ и след това на „y-3 = 6“, за да направим и двата кодови блока.
И така, това ни даде очаквания резултат, който може да се види на изображението по-долу:
Сега, за да избегнем тези обратни точки и да изобразим обратните точки като част от обикновен текст, трябва да вмъкнем обратните наклонени черти преди двете двойки обратни точки.
Математическият израз, който добавихме, се показва със задни отметки като обикновен текст и като кодов блок в markdown.
Заключение
Обратните отметки се добавят в маркирането, за да се покаже конкретен текст или скрипт в кодовия блок. В това ръководство обсъдихме необходимостта от избягване на обратната отметка, когато искаме да добавим съдържание като обикновен текст с обратна отметка, без да задействаме тяхната функционалност. Обсъдихме как се прилагат обратните отметки за създаване на кодови блокове и след това ви предоставихме решение, което е да добавите обратна наклонена черта (\) преди обратната отметка, така че да се показва като обикновен текст и да не активира кодовия блок създаване.