the_permalinkはループ内で投稿のURLを表示したい時に使用する関数です。
PHP
the_permalink();
このタグはループ内で使用する必要があります。
パラメータ
PHP
the_permalink( $post );
「post」パラメータには「投稿 or 固定ページの整数型のID」もしくは「投稿オブジェクト」が入ります。
※デフォルトは$post(表示中の投稿情報)
海外版のCodexにデフォルトは$postと難しく書いてあったが、基本はループ内で現在の投稿URLを引っ張ってくる認識でOKかと。
また、ループ内であれば投稿ID(カーソル合わせると見れる数字)をパラメータに含めることで、指定の記事URLを表示できました。
テーマ開発での使用例
ループ内で記事ページにリンクを繋げるときに使用することが多いです。
PHP
<a href="<?php the_permalink(); ?>">
<h3><?php the_title(); ?></h3>
</a>
関数の内部でエスケープ処理をしてくれるのでエスケープ処理は不要です。
※the_から始まるテンプレートタグはエスケープ処理不要なケースが多い