standart Markdown
Markdown, John Gruber tarafından geliştirilen bir standarttır. Markdown ile asıl amaç, dosyanın saf metinde bile okunmasını mümkün kılmaktır. Yalnızca metin içeren bir düzenleyiciye bakmak istiyorsanız, onu okumak için kolay bir zamanınız olmalıdır. Bu, vim ve benzeri kullanıcılar için çok yararlıdır. Not ve bunun metin dosyalarını değiştirmek için bir standart olduğunu unutmayın. HTML'nin yerini almıyor. Bunun yerine, yararlı olduğu yerde HTML oluşturmak için kullanırsınız. GitHub durumunda, sitedeki Benioku dosyasını biçimlendireceklerdir. Standardı takip ettiğiniz sürece, iyi görüneceğinden emin olabilirsiniz.
GitHub sadece birkaç uzantı eklediğinden, bir Markdown hile sayfası kullanarak başlamalı ve oradan gitmelisiniz. İşte en yaygın olanların bir listesi.
indirim | Uzantılar | Sonuç |
# (seviye başına 1) | Başlıklar | |
* | italik | |
** | kalın | |
> | blok alıntı | |
1. (vb.) | Sıralı Liste | |
- | Sırasız liste | |
'kod' | Senin kodun | |
"' | Md-dahili | Bir kod bloğunu başlatın ve sonlandırın |
- | Yatay kural | |
[Açıklama](https://www.misal.com) | Kare içinde bir ad ve normal parantez içinde URL | |
![alt metin](resim.png) | Aynı, bir resme bağlantı | |
[1] | Md-dahili | bir dipnot |
Listeler, iç içe olmasını istediğiniz öğeleri girintileyerek iç içe yerleştirilebilir.
Normal Markdown'ın diğer uzantıları, yukarıdaki kod blokları uzantılarına sahipsiniz. Hizmetler tarafından her zaman desteklenmezler.
indirim | Uzantılar | Sonuç |
### #özel kimlik başlığı | Md-dahili | Kimliğine göre hitap edebileceğiniz bir başlık |
terim: tanım | Md-dahili | Tanımları olan terimlerin listesi |
~Yanlış Metin~ | Md-dahili | üstü çizili metin |
- [x] Yapılacak görev | Md-dahili | İşaretleyebileceğiniz bir görev listesi |
Tablo çok basit, ancak bunu göstermek için birkaç satıra ihtiyacınız var: Tablo:
| İsim | DEĞER|| ----------- | ---------- |
| Paspaslar | 100 |
GitHub Uzantıları.
GitHub, diğer insanlara ve projelere olan bağlantıları yönetmeyi kolaylaştırmak için birkaç uzantı ekledi. Bunlardan bazıları daha önce bahsedilen tablolardır. Size en çok yardımcı olacak olan otomatik bağlantı uzantısıdır. GitHub'da kullandığınızda kendi başına bir bağlantı oluşturur.
Diğerleri tablolar ve Görev listesi öğeleridir. Bunlar, projelerdeki görevlerinizi takip etmek için uygundur. Sonuncusu, Disallowed Raw HTML uzantısıdır. Bu uzantının yardımıyla, HTML için oluşturulurken bazı etiketler filtrelenir. Bu etiketler GitHub'da oluşturulurken garip etkilere neden olabilir.
GitHub Markdown'ı keşfetmenin yolları
Kafa karıştırıcı bulursanız GitHub sayfasına gidebilir ve yerleşik düzenleyiciyi kullanabilirsiniz. Kullandığınızda, bazı işlevleri otomatik olarak tamamlayacaktır. Bu sadece sorunlar için işe yarar, ancak bazı şeyleri anlamak için kullanabilirsiniz, iki nokta üst üste yazdığınızda emojiler bir liste olarak çıkıyor (:).
Ayrıca GitHub'da harika görünümlü README dosyasına sahip bir proje bulabilir ve onu yerel sürücünüze kopyalayabilirsiniz. Oradan, istediğiniz herhangi bir düzenleyiciyi kullanarak dosyayı keşfedebilirsiniz. Büyük editörler, Emacs ve Vim için, uzantılar aracılığıyla işaretleme desteği var.
Vim kullanıyorsanız, GitHub, vim-markdown'dan bir sözdizimi vurgulama uzantısı koyabilirsiniz. Bu uzantı size kodu doğru yaptığınızı gösterir. Bittiğinde nasıl göründüğünü görmenize yardımcı olmak için canlı işaret uzantısını da alabilirsiniz. Bununla, siz yazarken sonucu canlı olarak gösteren, çalışan bir web sunucusuna sahip olabilirsiniz.
Emacs ile sabırsız modunuz, canlı aşağı modunuz ve Gerçek Zamanlı önizlemeniz var. Hepsi, siz yazarken ortaya çıkan sayfanızı bir tarayıcıda gösterir. İlki, ikincisinden daha az kitaplık gerektirir, ancak çalışması için fazladan bir kod parçacığına ihtiyaç duyar.
Sonuç
Markdown küçük ve kasıtlı olarak basit bir spesifikasyon olsa da, başlamak biraz kafa karıştırıcı olabilir. Öğrenmenin en iyi yolu bir hile sayfası kullanmak ve Markdown belgenizi yazmaktır. README'nizi güncelleyebilirsiniz.md'yi GitHub'da kullanabilirsiniz ve editörlerinizin yerleşik işlevlerinden çok fazla destek alabilirsiniz. Bir yan not olarak GitHub, belgenize ekleyebileceğiniz emojileri de destekler. Hangilerinin olduğunu bulmak için hile sayfasını kullanabilirsiniz.
Markdown-CheatSheet'i Buradan İndirin