Natknąłem się na wiele wzmianek o wsparciu MultiMarkdown dla wewnętrznych linków / nazwanych kotwic, ale nie jestem w stanie znaleźć ani jednego przykładu jak to zrobić.
Jaka jest więc składnia oznaczenia nazwanej kotwicy i jaka jest składnia linkowania do niej tak samo jak linkowania do jakichkolwiek innych adresów URL (używając tylko #foo zamiast http://....
)?
markdown
multimarkdown
masukomi
źródło
źródło
Odpowiedzi:
W standardowym Markdown umieść kotwicę w
<a name="abcd"></a>
miejscu, do którego chcesz utworzyć link, i odwołuj się do niej na tej samej stronie[link text](#abcd)
.(To wykorzystuje,
name=
a nieid=
, z powodów wyjaśnionych w tej odpowiedzi .)[link text](http://...#abcd)
Oczywiście można korzystać ze zdalnych referencji .To działa jak sen, pod warunkiem, że masz kontrolę nad tekstem źródłowym i docelowym. Kotwica może nawet pojawić się w nagłówku, a zatem:
produkuje:
Nagłówek w tym wpisie SO!
i możemy nawet link do tego, aby:
(W przypadku SO łącze nie działa, ponieważ kotwica jest usuwana).
źródło
<a id="id"></a>
formularz jest najlepszy. Zobacz to SO pytanie / odpowiedź .name=
był przestarzały w XHTML, ale teraz okazuje się, żeid=
ma efekt uboczny w HTML5, więc wracam doname=
tej odpowiedzi.Jeśli masz nagłówki w plikach przeceny, możesz bezpośrednio połączyć je w pliku.
Nagłówek Markdown -
## The Header
wygeneruje to domyślny identyfikator
#the-header
(zamień spacje wewnętrzne na łączniki i umieść małe litery).Aby przejść do tego identyfikatora, możesz utworzyć następujący link:
[Link to Header](#the-header)
Jest to równoważne z:
<a href="#the-header">Link to Header</a>
Pamiętaj, że nazwa odwołania jest małą literą
#header
.źródło
## This Header ##
, link będzie[To This Header](#markdown-header-this-header)
. Jeśli nie masz pewności, jaki jest identyfikator nagłówka, użyj inspektora strony, aby zobaczyć wartości HTML.[Link](user-content-the-header)
Zaczerpnięte z Multimarkdown Users Guide (podziękowania dla @MultiMarkdown na Twitterze za zwrócenie na to uwagi)
[Some Text][]
będzie link do nagłówka o nazwie „Some Text”np
Opcjonalna etykieta do wyboru, aby ułatwić jednoznaczne przypadki, w których wiele nagłówków ma ten sam tytuł:
źródło
Testowałem Github Flavored Markdown przez chwilę i mogę podsumować za pomocą czterech zasad:
-
Na przykład, jeśli twoja sekcja ma taką nazwę:
Utwórz link do niego w ten sposób:
źródło
Najlepszym sposobem tworzenia wewnętrznych linków (związanych z sekcjami) jest utworzenie listy, ale zamiast linku wstaw #section lub # section-title, jeśli nagłówek zawiera spacje.
---- MARKDOWN ------------------------
---- PODGLĄD LISTY ------------------------
---- HTML ------------------------
Nie ma znaczenia, czy jest to nagłówek h1, h2, h3 itp., Zawsze odwołujesz się do niego za pomocą tylko jednego
#
.Wszystkie odniesienia na liście sekcji należy przekonwertować na tekst pisany małymi literami, jak pokazano w powyższym przykładzie.
Link do sekcji powinien być pisany małymi literami. W przeciwnym razie to nie zadziała.
Ta technika działa bardzo dobrze dla wszystkich wariantów Markdown, także MultiMarkdown.
Obecnie używam Pandoc do konwersji formatu dokumentów. Jest znacznie lepszy niż MultiMarkdown.
Przetestuj Pandoc tutaj
źródło
## Hello
, powinieneś nazywać go[Whatever you want](#Hello)
W mdcharm wygląda to tak:
źródło
Oto moje rozwiązanie (pochodzące z
SaraubhM
odpowiedzi)**Jump To**: [Hotkeys & Markers](#hotkeys-markers) / [Radii](#radii) / [Route Wizard 2.0](#route-wizard-2-0)
Co daje ci:
Przejdź do : Skrótów i znaczników / Radii / Route Wizard 2.0
Uwaga zmiany od
i
.
do-
, a także utratę&
w linkach.źródło